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Introduction 


Thank you for choosing AmiBroker. This guide wiii heip you get up and running. 

AmiBroker is a comprehensive technicai anaiysis program, with an advanced charting, back-testing and 
scanning capabiiities. it gives everything you need to trade successfuiiy. Just check out our quick features 
tour to find out what is inciuded in this powerfui software package. 

if you are a first time user and just instaiied the software piease check out Tutoriai section that wiii guide 
you through most important aspects of using AmiBroker. 

The next chapter - Reference guide - provides detaiied description of every window and more technicai 
documentation covering ASCii importer and automation interface. 

in the Technicai anaiysis guide you wiii find materiai that wiii introduce you to the worid of charting and 
technicai indicators. 

The next part of the guide describes AmiBroker Formuia Language - a powerfui tooi that aiiows you to create 
your own trading systems, scans, custom indicators and commentaries. You wiii find the description of the 
ianguage and its syntax, a compiete reference of aii functions and more. 

The iast part is provided for the user's of previous versions - this chapter wiii heip them finding out what new 
features were added without the need to re-read aii documention. 
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About AmiBroker Editions 

AmiBroker software is currentiy avaiiabie in 2 editions: Standard and Professionai. 


The foiiowing tabie summarizes differences between these two editions: 


Feature 

Standard Edition 

Professionai Edition 

End-of-day charting/backtesting/scanning 

Yes 

Yes 

1-, 5-, 15- minute, hourly Intraday 
charting/backtesting/scanning 

Yes 

Yes 

Custom minute bars 

Yes 

Yes 

Tick charts/backtesting/scanning 

No 

Yes* 

1-second, 5-second, 15-second bar 
ch arts/backtesti ng/scan n i ng 

No 

Yes 

Streaming real time quote display 

10 symbols 

UNLiMiTED symbois 

Time and Sales window 

1 symbol 

UNLiMiTED symbois 

GetRTData / GetRTDataForeign AFL function 

No 

Yes 

Wait for backfill in Automatic Analysis 

No 

Yes 

Automatically updating real time charts 

Yes 

Yes 

Maximum Adverse/Favourable Excursion Distribution 
charts 

in Portfolio backtest reports 

No 

Yes 

64-bit version 

No 

Yes 

Multi-threading Charts 

Yes 

Yes 

Multi-threading Analysis window 

Yes, upto 2 threads 

Yes, upto 32 threads ** 


No 

Not required, but nice to 
have 

Requires RT data subscription 


(Professional Edition 
works with EOD data 
perfectly fine, but 
real-time features (like 
real-time quote) of 
course are require 
real-time data source) 


* - this feature is avaiiabie oniy using eSignai RT, Interactive Brokers, DDE feed 

In the future the Professional Edition may have additional extra features not available in Standard Edition. For 
pricing and ordering information check out How to order section. 


** - the number of threads depends on number of logical processors on your computer and number of 
symbols under test. For details see: Efficient use of Multithreading. 
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Quick Tour 


Basic features 

Powerful charting 

• object-oriented drawing tools (trend lines, rays, parallel lines, regression channels, fibonacci 
retracement, expansion, Fibonacci time extensions, Fibonacci timezone, arc, gann square, 
gann square, cycles, circles, rectangles, text on the chart, and more) 

• drag-and-drop indicator creation - allows you to create complex Indicators without writing single 
line of code 

• modern, fully customizable user interface 

• Instant viewing of Intraday/dally/weekly/montly charts In line, bar or candlestick styles overlaid with 
configurable moving averages, Bollinger bands. Volume chart, SAR, etc. 

• ability to display most common 1-, 5-, 15-, 60- minute Intraday charts as well as fuiiy customizabie 
N-minute charts (where N is 1..1380 ) 

• 5-second and 15-second bar charts (RT version) 

• tick charts, custom N-tick charts (RT version) 

• muitipie time frame charts 

• on-the-fly time compression - no need to wait when switching between various chart periodicities 

• reiative performance charts 

• tens of most popular Indicators bullt-ln Including ROC, RSI, MACD, OBV, CCI, MFI, NVI, Stochastics, 
Ultimate oscillator, DMI, ADX, Parabolic SAR, TRIM, Advance/Decllne line, Accumulatlon/Dlstrlbutlon, 
TRIX, Chaikin oscillator, unique risk-to-yleld map and more 

• study drawing tools Including trend lines, horizontal/vertical lines, Fibonacci retracements and 
timezones, text boxes 

• multiple chart panes, windows, different views and time scales are possible all at the same time 

• extermely fast zooming and live scrolling 

Muitipie data feeds 

AmiBroker Is capable of handling virtually ANY exchange In the world. 

• Reai-time streaming quotes via eSignai's TurboFeed featuring access to aii US exchanges and 
major European exchanges. 

• Reai-time streaming quotes via myTRACKfeed, iQFeed, QCharts/Quote.com, QuoteTracker, 
interactive Brokers, any DDE-enabied data feed 

• Direct feed from Quotes Plus, TC2000, Fastirack and Metastock (Including Intraday) databases. 
Read more... 

• User-configurable ASCII Import wizard - allows you to read quotes In the format you can define 
(Including Intraday)! 

• Bullt-ln Metastock(R) database Importer - reads directly all symbols from your Metastock database 
(works with both EOD and Intraday modes) In a matter of seconds! 

• AmIQuote downloader program provides quick way of obtaining free end-of-day from major world 
exchanges (all US markets, LSE, ASX, Paris, Milan, Frankfurt) 

• Free FOREX data downloadable via AmIQuote 

• Free historical Intraday delayed quotes from US exchanges downloadable via AmIQuote 

• Script-driven, one-click automatic downloaders available for NYSE, Amex, Nasdaq, Australian Stock 
Exchange, Johannesburg Stock Exchange, Warsaw Stock Exchange 

AmiBroker Is successfully used In the following countries: USA, Canada, United Kingdom, Australia, 

Germany, Italy, Southern Africa, Poland, Roland, Norway, France, ... 
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For more information on data sources for AmiBroker ciick here. 

Symbol & quotes database 

AmiBroker features advanced database system that offers the foilowing: 

• build-up and store historical tick or 5- or 15-second bar data for backtesting purposes (certain 
RT data sources only) 

• build-up and store intraday minute-bar or end-of-day data for backtesting purposes 

• uniimited number of symbois and unlimited number of quotes 

• multiple database support 

• stores quotes, company information, financial results, categories, industry/sector information 

• powerful filtering by sector, industry, group and market 

• innovative symbol tree browser showing symbols grouped by sectors, industries, indexes 

• automatic handling for composities (number and volumes of advancing, declining and unchanged 
symbols) 

• automation support allowing you to control your database from external programs written in any 
language including Java Script, VBScript 

AmiBroker Formula Language 

The language 

The AFL is an advanced formula language that allows you to create your own indicators, trading systems and 
commentaries. It is specialy designed for traders so writing analysis formulas is easier and quicker than in 
general-purpose languages. 

AFL features more than 200 built-in AFL functions to use as a building blocks for your formulas. AFL includes 
trigonometric, averaging, statistical, data manipulation, conditional, pattern-detection and predefined indicator 
functions. 

AFL supports unlimited variables, unlimited parentheses nesting, unlimited nested function calls and multiple 
logical operators. Version 4.40 brings completely rewritten engine with native flow-control and looping (if-else, 
while), user-defined functions and procedures with local and global variable scope. 

New version 4.50 provides native multiple time-frame support, so you can mix different bar intervals in single 
formula. 

Formula Editor / Drag-drop charting 

Formula Editor allows you to quickly re-create any indicator/study found in the literature. Drag and drop 
charting allows to create complex overlays, indicators-on-indicators and more. Among other things it is 
possible to: 

• any number of graphs that can be overlaid in the same chart pane 

• modify built-in indicators 

• custom or automatic scaling 

• flexible grids 

• access to composite data (number/volume of advancing, declining, unchanged issues) 

Formula - based alerts 
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• Ability to write complex formula-based alerts that can be displayed on the screen, sent to you via 
e-mail, plus play a user-defined WAV file. 

• Ability to run external applications via alerts - this allows automated trade execution 

PORTFOLIO-LEVEL system back-testing, optimization, explorations and screening 

Screening: Automatic analysis window enables you to scan your database for symbols matching your defined 
buy/sell rules. AmiBroker automaticaly produces the report telling you if buy/sell signals occurred on given 
symbol in the specified period of time. 

Exploration: search your database for symbols matching your criteria and create the report showing the data 
you want to see: indicator values, past performance, etc. Then sort the results by any value listed. 

Back-testing: AmiBroker can also perform full-featured back-testing of your trading strategy, giving you an 
idea about performance of your system. 

The back-testing engine highlights: 

• PORTFOLIO LEVEL BACKTESTING/OPTIMIZATION 

• Three-dimensional (3D), fully animated charts of optimization results 

• Advanced custom backtester interface 

• User-definable backtest metrics 

• Different position sizing / money management techniques based on Portfolio Equity 

• Hyper-fast execution - AmiBroker can backtest 10000 symbols (3000 data bars each) = 30 
million data points in FIVE minutes! 

• Integrated support for MULTIPLE time-frames in single formula 

• NEW Report Explorer provides great way to organize/compare/view all backtest results 

• Scanning/Exploration/Backtest/Optimization on Real Time data (tick and up) (RT version only) 

• Scanning/Exploration/Backtest/Optimization on intraday data (1-min bars and up) 

• Back testing whole exchange or only limited, user-definable set matching your market, group, 
industry, sector selection 

• Equity curve plotting. Equity rainbows, composite equities curves 

• Test long, short or both long and short trades 

• Maximum-loss stop, profit-target stop, trailing-stop, N-bar (time) stop 

• Realistic back-testing 

• Ability to control position size from your formula (Read more...) 

• Create your own composites and scan/backtest them 

• Detailed reporting giving you imporant statistics of your system. 

Optimization: AmiBroker allows you to optimize your trading system with up to 10 optimization variables on 
single or MULTIPLE securities at once! 

Automatic Chart Commentaries and Interpretation 

• Full, textual descriptions of actual situation on the market 

• automatic buy-sell arrows visible on the charts 

• automatic textual interpretation of indicators and price chart (Window->lnterpretation) 

Scripting/COM/DLL support 

• AFL engine allows embedding VBScript/JScript code within AFL formulas providing UNLIMITED 
possibilities 
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• ability to call external COM (ActiveX) objects from the AFL formula 

• free SDK (software development kit) for registered users allowing writing indicator DLLs (plug-ins) 

• many already available 3rd party plug-ins 

Additional features 

Portfolio manager 

Built-in portfolio manager helps you track your investments. It allows you to registed buy/sell 
transactions, calculates brokerage commission, dividend (with setable dividend tax), cash 
deposits/withdrawals. You get the instant calculation of your equity value, percentage and 
point yield. 

Scripting support 

AmiBroker features automation interface that exposes objects and methods that could be 
accessed from any programming language including scripting dialects such as JScript 
(JavaScript) and VBScript. The scripting capabilities of AmiBroker allows you to automate 
time consuming database management tasks. Using scripting you will be able to create 
automatic downloaders, maintenace tools, exporters customized to your specific needs. 

Internet integration 

AmiBroker features built-in web browser that allows you to quickly view company profiles. The 
profile viewer is completely configurable so you can set it up for your particular exchange. 

The settings are market based so you can access different web sites for each market 
automatically. No longer will you be forced to waste your time browsing manually to get the 
latest news and symbol related information. 

Configurability 

AmiBroker is designed to be configurable and customizable in almost every area. It is not tied 
to particular exchange or data provider. Thanks to flexible import methods and scripting you 
will be able to adopt it easily to your favourite market(s). Also technical analysis tools built in 
into AmiBroker allow you to change every parameter with easy, and if you want even more, 
you can create your own indicators using flexible formula language. 
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Getting started 

Hardware requirements 
Supported operating systems 
Installation and running 
Getting help 

Hardware requirements 

To run AmiBroker you need PC-Compatible computer meeting following minimum requirements 

• Pentium 450 MHz or higher 

• 128 MB RAM 

• 20 MB hard disk space 

• 256 color graphics card (high color recommended) 800x600 minimum screen resolution 
Recommended machine configuration 

• CPU: 1GHz or more, multiple cores 

• 512 MB RAM or more 

Supported operating systems 

AmiBroker works on the following operating systems: 

• Windows 10 (any edition) 32-bit 

• Windows 10 (any edition) 64-bit 

• Windows 8 (any edition) 32-bit 

• Windows 8 (any edition) 64-bit 

• Windows 7 (any edition) 32-bit 

• Windows 7 (any edition) 64-bit 

• Windows Vista (any edition) 32-bit 

• Windows Vista (any edition) 64-bit 

• Windows Server 2008 (any edition) 32-bit 

• Windows Server 2008 (any edition) 64-bit 

• Windows Server 2008 R2 (any edition) 64-bit 

• Windows XP (any edition) 

• Windows XP x64 (64-bit) 

• Windows 2000 (any edition) 

• Windows NT 4.0 SP 3 (or higher) -i- Internet Explorer 4.0 or higher installed 

• Windows Millenium 

• Windows 98/98SE/95osr2/95 

For more information about OS compatibility see: 32-bit/64-bit version compatibility chart 

Installation and running 

Install AmiBroker using it's setup program - it is available for download from 

http://www.amibroker.com/download.html. After downloading double click on the program's icon. This will 
launch the setup program - you can safely accept all default values by clicking "Next" on each page and 
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"Install" on the last page. By default AmiBroker is instaiied to "C:\Program Fiies\AmiBroker" directory and this 
iocation is referred to as "main AmiBroker directory". 

If setup program asks you to restart machine piease do so to aiiow to repiace system components. 

After instaliation, you can start AmiBroker from Windows' standard Start->Programs->AmiBroker->AmiBroker 
menu. 

Just after starting AmiBroker splash window shows up, then for few seconds AmiBroker loads its quotation 
database. Next the main AmiBroker screen appears. 

AmiBroker main screen with price chart, 

MACD and RSI indicators and profile view open. (Windows version) 

In default setup you can see the toolbar, workspace window with symbol list on the left side and chart 
windows on the right side. 

The toolbar provides fast access to the most often used program functions. With the symbol list view you can 
select active symbol. Changing the selection will cause chart redraw and update in some information windows 
if they are open. The chart windows let you to analyse current price trends and the behaviour of technical 
indicators. 

You can quit AmiBroker using the F/Ve/Ex/f menu item. 

Getting help 

AmiBroker features new context-senstive help system, available bv pressing F1 kev anywhere in the 

program. 

When you press F1 key while any window and any menu is shown, AmiBroker opens up a relevant help file 
page describing the window or menu in question. No more searching through the help file. 

In addition to using F1 context-sensitive help it is highly recommended to read ALL Tutorial articles first. The 
answers to most common problems are given there. In case of major problem check Troubleshooting guide. 
Also there is a "Search" tab on the left of this on-line help window that allows to quickly locate information by 
keyword(s). Just type word(s) you are looking for and click "Display". 

In case of further questions/problems you may check the following resources: 

• AmiBroker web page - which is searchable using "Search" box in the top left corner of the page. 

The page gives you an access to: 

♦ AmiBroker Tips newsletter containing valuable step-by-step instructions on using various 
aspects of AmiBroker 

♦ Support area - featuring additional documentation 

♦ Frequently Asked Questions - the list of most commonly asked questions with the answers 

♦ AFL Library - featuring ready-to-use AFL formulas for custom indicators, commentaries and 
trading systems 

♦ Members area - featuring material accessible by registered users only 

• AmiBroker mailing list - the place where you can meet other AmiBroker users, ask questions and 
share with ideas (with searchable archive). To subscribe please send an empty e-mail to: 
amibroker-subscribe@egroups.com. To unsubscribe please send an empty e-mail to 
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amibroker-unsubscribe@egroups.com. 

Checking these piaces first wiii heip me focusing on deveioping new features in AmiBroker. In case of 
probiems not covered in above resources piease don't hesitate to contact me at: support@amibroker.com. 
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AmiBroker 32-bit vs 64-bit Compatibiiity Chart 

SUMMARY 


The following table clearly shows that AmiBroker Professional 32 bit runs on EVERY Windows version (BOTH 
32 and 64-bit) and with every data plugin. 64-bit version of AmiBroker runs solely on 64-bit versions of 
Windows and only with limited number of data sources due to lack of data vendors' API support for 64-bit 
technology. 



AmiBroker Professionai 

32-bit 

AmiBroker Professionai 

64-bit 

Operating systems 

Windows 10 32-bit 

Yes 

No 

Windows 10 64-bit 

Yes 

Yes 

Windows 8 32-bit 

Yes 

No 

Windows 8 64-bit 

Yes 

Yes 

Windows 7 32-bit 

Yes 

No 

Windows 7 64-bit 

Yes 

Yes 

Windows Vista 

Yes 

No 

Windows Vista x64 

Yes 

Yes 

Windows Server 2008 (32-bit) 

Yes 

No 

Windows Server 2008 x64 (64-bit) 

Yes 

Yes 

Windows XP 

Yes 

No 

Windows XP x64 (64-bit) 

Yes 

Yes 

Windows 2000 

Yes 

No 

Windows NT 4 

Yes 

No 

Windows Millenium Edition (ME) 

Yes 

No 

Windows 98 

Yes 

No 

Windows 95 

Yes 

No 


Addressable memory space 


32-bit Operating System 

2GBor3GB3) 

N/A 

64-bit Operating System 

4 GB 

1000 GB 


Data sources 

AmiQuote (Yahoo, MSN, Google Finance) Yes Yes 
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Metastock import 

Yes 

Yes 

Metastock plugin 

Yes 

Yes 

eSignal RT 

Yes 

Yes 

IQFeed RT 

Yes 

Yes 

Interactive Brokers 

Yes 

Yes 

Premium Data (via Metastock plugin) 

Yes 

Yes 

TC2000/TCNet 

Yes 

No2) 

FastTrack 

Yes 

No2) 

DDE 

Yes 

Yes 

ODBC database 

Yes 

Yes 

any ASCII file (via import) 

Yes 

Yes 


Remarks: 

64-bit native version of this plugin possible and is under development 

64-bit native version of this plugin is not technically possible because of lack of 64-bit API from data vendor 
at the moment 

3GB addressable memory is only possible with /3G switch in 32-bit Windows BOOT.INI file 
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What's new in the latest version? 

Highlights of version 6.00 

Version 6.00 brings iots of new functionaiity especiaiiy with regards to system testing. There are hundreds of 
new features and changes to existing functionaiity as compared to version 5.90, listed in detail in "Release 
Notes" document in AmiBroker directory. Below is just a short list of few of them: 

• Integrated high-performance Monte Carlo simulator - with cumulative distribution charts of equity, 
max. drawdowns, support for custom user-definable metrics and ability to peform MC simulator driven 
optimizations. 

• Full Matrix support (two dimensional arrays) in AFL with direct native matrix arithmetic (matrix 
operations like addition, subtraction, multiplication, division, transpose, etc), see Matrix, Mxidentity, 
MxTranspose, MxGetSize 

• Detailed Buy-and-hold (benchmark) statistics automatically added to the backtest reports 

• User definable stop precedence (SetStopPrecedence function) and stop validity 
(ValidFrom/ValidTo parameters in ApplyStop function) 

• Sparse array support: SparseCompress, SparseExpand 

• Infinite Impulse Response filter function (MR) for efficient implementation of higher order smoothing 
algorithms 

• Raw text output in explorations via AddRow function 

• New styles supported by Exploration XYCharts 

• Variable period Percentile function 

• Unicode (UCN) support in PlotText, PlotTextSetFont, GfxDrawText, GfxTextOut, chart titles, 
interpretations and commentary windows (allows various graphic annotations / windings ) 

• New Low level graphic functions: GfxSelectFlatchBrush, GfxSelectStockObject 

• wildcard matching function StrMatch 

• enhanced Assignment Organizer 

• Word-wrap functionality in AFL editor and enhanced "Code Prettify" function 
Highlights of version 5.90 

In addition to completely new functionality this version focuses on speed improvements and 
enhancements of existing functionality. There are hundreds of new features and changes to existing 
functionality as compared to version 5.80, listed in detail in "Release Notes" document in AmiBroker directory. 
Below is just a short list of few of them: 

• Performance improvements 

♦ AFL Engine: custom memory allocator does not use Microsoft runtime lib for reference 
tracking anymore. Result - complex formulas with lots of loops and OLE (especially 
low-level custom backtests) run upto 3 times faster in 32 bit and 4 times faster in 64-bit 

♦ execution speed improved by factor > 2x for AFL functions: MACD, Signal, CCI, Sum 
(variable period) 

• Brand new Code Snippets window and keyboard triggers 

♦ added Code Snippets window - allows inserting/deleting/saving selected parts of the formula 
as snippets. Also implemented is convenient drag-drop of snippet to the formula edit window 

♦ Code snippets are available in auto complete list (type @ plus first letter of snippet key 
trigger), and even without auto complete activated @keytrigger is replaced by snippet text 

• Re-designed Report Explorer and improved Report Viewer (HTMLView) 

♦ Column layout (order and sizes) is now saved and restored between runs 

♦ Loading and refresh performance significantly improved (5x) using owner draw/virtual mode 
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♦ Multi-column sorting implemented 

♦ Numeric columns are now right aligned for better readability 

♦ visuals significantly improved (list uses modern style, grid lines, immediate column resizing, 
double buffering for no flicker, thousand separators, negative values are displayed in dark 
red, HighDPI aware, changed toolbar) 

♦ HTMLView - Backtest report viewer - added Edit/Copy, Edit/Select All and Edit/Copy TABLE. 
The last command transforms HTML tables into CSV format and copies it into clipboard so 
tables can be pasted easily to Excel. Also it divides Entry/Exit columns into separate 
Entry/exit date/price columns 

• new Bid/Ask trend indicator in Reai-time quote window - a graphical indicator showing the 
direction of 10 most recent changes in real-time bid/ask prices The right-most box is most recent and 
as new bid/ask quotes arrive they are shifted to the left side. 

• User-definabie HTML backtest reports 

♦ now it is possible to output HTML instead of graphics in report chart formulas using AFL: 
EnableTextOutput( 3 ) - HTML output to backtest report 

♦ rewritten 3. Profit Table.afI using HTML embedding features auto-scalable layout (so it 
enlarges when numbers are bigger), bold summary columns, negative values in red, 
boundary date changed to last day of year/month 

• Charting improvements 

♦ Left/right extended Trend lines and Rays now use user-definable Extension Factor (new field 
in Study properties) instead of always infinite extent. Ext. Factor equal to ZERO means 
INFINITE, other values 0.1 ... 26 define how far to the left/right line is extended 

♦ Max zoom achievable via View->Zoom Out is increased to 5 million bars, also 
Pref/Charting/Default zoom limit set to 5 million. 

♦ Line drawings now have user definable line width in pixels (new "Line width" field in Study 
Properties dialog). In addition to that "Thick line" box makes line twice as wide (so actual 
width of thick line is 2 * lineWidth instead of adding 1 pixel to width) 

♦ added ability to control number of decimals in chart value labes via GraphLabelDecimals 
variable (example, adding GraphLabelDecimals = 2; to the formula would give you value 
lables with 2 decimal places) 

• User Interface improvements 

♦ Parameter window look and feel improved. Item height is increased and slider thumb made 
wider for easier use on small size/high DPI screen 

♦ New Analysis Ul refreshes faster 

♦ Colors, bold and italic styles are now added to Interpretation and Commentary windows 

♦ Filter dialog now shows number of matching symbols in real-time 

♦ Column setup dialog has new Mark All / Toggle All buttons 

• AFL new features / improvements: 

♦ new AFL functions: GetFormulaPath, NullCount, Sort, Reverse, StrSort, StrTrim, SendEmail 

♦ extended functionality of AFL functions: StrExtract, StrMid, RestorePriceArrays, PlotGrid, 
EnableTextOutput, GetOption 

♦ single-characters literals added to AFL 

• Stabiiity & debug improvements 

♦ added lots of parameter checks 

♦ 64-bit version has now call stack trace in the bug report for better debugging 

♦ added more memory checks, early warnings and error messages when running out of 
memory 

♦ added checks for unusual, yet potentially 'troublemaker' scenarios 

Highiights of version 5.80 
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In addition to compieteiy new functionaiity this version focuses on incrementai improvements and 
enhancements of existing functionaiity. There are hundreds of new features and changes to existing 
functionaiity as compared to version 5.70, iisted in detaii in "Reiease Notes" document in AmiBroker directory. 
Beiow is just a short iist of few of them: 

• Brand-new completely rewritten AFL Formula Editor that supports the foiiowing features: 

♦ Improved Syntax highlighting 

♦ Automatic brace matching/highlighting (NEW) 

♦ Auto indentation (NEW) 

♦ Indentation markers (NEW) 

♦ Enhanced auto-complete in two modes (immediate (NEW) and on-demand) 

♦ Parameter information 

♦ Line numbering margin and selection margin (NEW) 

♦ Code folding (NEW) 

♦ In-line Error Reporting (NEW) 

♦ New tabbed user interface with ability to work in both MDI and separate floating frame mode, 
can be moved behind main AmiBroker screen and brought back (Window->Toggle Frame) 
(NEW) or kept on top (Window->Keep on top) 

♦ Rectangular block copy/paste/delete (Use mouse and hold down left Alt key to mark 
rectangular block) 

♦ Enhanced printing (with syntax highlighting and header/footer) 

• Code snippets - these are small pieces of re-usable AFL code. They can be inserted by right-clicking 
in the AFL editor window and choosing "Insert Snippet" menu. Code snippets are user-definable. 

• New features In Low-level graphics 

♦ multiple Z-order layers GfxSetZOrder 

♦ co-ordinates can now be given in both pixels and bar-price mode GfxSetCoordsMode 

♦ speed improvements (upto 3x) 

• Persistent Static variables - StaticVarSet/StaticVarSetText (added 'persistent' parameter) 

• Analysis (Backtest/Optimize) enhancements 

♦ new "Trade using FX cash conversion" setting 

♦ 64-bit SPSO/Tribes engine fixes 

• New/enhanced AFL functions 

♦ PlotTextSetFont (NEW) 

♦ GfxSetCoordsMode (NEW) 

♦ GfxSetZOrder (NEW) 

♦ GfxGetTextWidth (NEW) 

♦ fopen (added 'shared' parameter) 

♦ StaticVarSet/StaticVarSetText (added 'persistent' parameter) 

♦ SetOption (new option "StaticVarAutoSave") 

♦ SetChartOptions (new flags chartDisableYAxisCursor, chartDisableTooltips ) 

♦ PlotText (new parameter yoffset) 

Highlights of version 5.70 

In addition to completely new functionality this version focuses on incremental improvements and 
enhancements of existing functionality. There are 116 new features and changes to existing functionality as 
compared to version 5.60, listed in detail in "Release Notes" document in AmiBroker directory. Below is just a 
short list of few of them: 

• Analysis Improvements: 

♦ New Multi-threaded Individual Optimization 
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♦ New general-purpose ranking functions 

StaticVarGenerateRanks/StaticVarGetRankedSymbols 

♦ User-definable ranking columns (via AddRankColumn function) 

♦ Lots of internal speedups in backtesting/optimization engine 

♦ SPSO, Tribes optimization engines now available also in 64-bit 

• Time&Sales improvements: user-definable filtering, user-definable colors, 2 user-selectable display 
modes 

• Database improvements: 

♦ 64-bit version supports files larger than 2GB per symbol 

♦ in-memory cache can hold upto 100 000 symbols (up from 20K) 

♦ new 64-bit DDE and ODBC plugins 

• Charting improvements: 

♦ Greatly improved performance QuickData technology implemented lowering CPU usage for 
charts 

♦ Edit->'Paste Special' allows to copy-paste entire chart pane with various options 

♦ Distance measuring when drawing trendlines (X,Y distance in the status bar) 

♦ X/Y constrains for drawing tools (press X and/or Y key to constrain movement in either X or Y 
direction when drawing) 

♦ ASCII importer adds support for millisecond timestamps 

• AFL improvements: 

♦ new functions: 

0 StaticVarGenerateRanks, StaticVarGetRankedSymbols - general-purpose 
user-definable ranking 

0 Error - display user-definable error messages (also useful for plugin developers) 

0 fdir - directory listing 

0 CategoryCreate - programmatic creation of watch-lists 
0 AddRankColumn - ranking columns in exploration 

♦ performance improved for Percentile() (order(s) of magnitude) 

♦ new fields supported in GetFnData 

♦ XShift support added to PlotShapes 

♦ speeded up transcendental mathfunctions (sqrt, sin,asin, cos, acos, tan, atan. In, loglO, etc) 

♦ improved SetSortColumns 


Highlights of version 5.60 

• Multithreaded GDI (graphics) rendering - now all drawing (graphic rendering) is done in separate 
worker threads so the user interface is way more responsive and charts are updated faster and 
completely independently from each other. 

• Automatic Walk-Forward out-of-sample summary report - each out-of-sample step produces 
individual report now, plus there is a new summary report that covers all out-of-sample steps. It is 
visible in the Report Explorer as last one and has "PS" type. 

• Enhanced color-coded backtest report 

• XY (scatter) charts in explorations 

• Chart themes and improved chart look (esp. the grid) 

• One-click automatic setup and update of stocks listing, sector and industry assignments for all 

major US exchanges 

• Unlimited ad-hoc chart intervals by means of new Interval combo box that accepts any interval 
typed manually 
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• support for ICB (Industry Classification Benchmark) categories in AFL, Ul, ASCII importer and OLE 
interface 

• native Gradient area charts 

• super-thick iines in Plot, PlotOHLC, PlotForeign 

• new AFL functions: GetAsyncKeyState, Inicb, IcbID, StaticVarInfo, SetGradientFill, 
XYChartAddPoint, XYChartSetAxis 

• updated AFL functions with new functionality: Status, CategoryGetSymbols, CategoryGetName, 
CategorySetName, CategoryAddSymbol, CategoryRemoveSymbol, CategoryFind, Plot, PlotOHLC, 
PlotForeign 

• new 64-bit eSignal plugin 

• updated Ul in many places 

• many other improvements (see Release Notes for details) 

Highlights of version 5.50 

• New Analysis window introduced in version 5.50 brings the following improvements over old 
Automatic Analysis 

♦ multi-threaded operation = speed - new Analysis window uses all available CPUs/cores to 
execute formulas in many threads in parallel providing significant speed ups. For example on 
4 core Intel 17 that can run upto 8 threads, it can run upto 8 times faster than old Analysis 
window. Exact speed up depends on complexity of the formula (the more complex it is, the 
more speedup is possible), amount of data processed (RAM access may be not as fast as 
CPU thus limiting possible speed gains). 

♦ non-blocking operation - you can now view, scroll and sort results of analysis while they are 
still generated, also as user interface thread is not used for processing for most part, charts 
and other GUI-driven program parts are way more responsive than with old automatic 
analysis 

♦ multiple instances - you can run more than one instance of New Analysis at a time, so you 
can run many scans/backtest/explorations/optimizations in parallel without waiting for one to 
complete 

♦ slicker user interface - New Analysis window can act as tabbed document, can be floated, 
buttons can be re-arranged for better workflow. There is way more space for the result list, 
extra information about execution is provided on the new "Info" tab. Also walk-forward results 
are now displayed within New Analysis window for less clutter. 

• Mini High-Low rank chart in Real Time quote window 

• User-definable mini bar charts in Explorations (see AddColumn function) 

• Add Rank Column feature - right-click Analysis result list and choose "Add Rank column" - it adds a 
column with ordinal rankings based on current sort or just row number column when list is not sorted 

• IRA account backtesting via SettlementDelay feature (see SetOption function) 

• Range bars algorithm improved significantly 

• new AFL functions: ThreadSleep, StaticVarCompareExchange 

• updated AFL functions with new functionality: AddColumn, SetOption, GetOption, 
CategoryGetSymbols, PopupWindow, GetFnData, ClipboardSet 

• updated OLE interface to support new Analysis window 

• updated custom backtester interface to support access to local, per-analysis EquityArray property 

• updated Ul in many places 

• Owner-draw list views for 10x speed improvement when displaying millions of rows 

• many other improvements (see Release Notes for details) 

Highlights of version 5.40 
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• Fully Multl-threaded charting. Massively parallel AFL execution (each chart pane runs in 
separate thread) allows to maximize speed and utilisation of modern multi-core / multi-CPU 
computers. For example on 8-core Intel 17 CPU your charts will run upto 8 times faster than in version 
5.30. The AFL engine has been completely rewritten from ground up to allow multiple instances of 
the engine running simultaneously. This enables not only multithreading but also enhances 
responsiveness of entire application, as even badly-written user formula used in a chart is not able to 
lock or slow the rest of the program. Multl-threading Is ON by default. It can be turned off by 
unchecking "Multi-threaded charts" box in Tools->Preferences, "AFL" tab but it is strongly 
discouraged. Multi-threading should be ON if you want AmiBroker to operate at full speed. 

• 12 new AFL functions 

♦ DateTimeAdd - adds specified number of seconds/minutes/hours/days to datetime 

♦ HMA - Hull Moving average 

♦ FIR - Finite Impulse Response filter 

♦ PercentRank - calculate percent rank 

♦ Lookup - search the array for bar with specified date/time 

♦ FirstVisibleValue - get first visible value of the array 

♦ LastVisibleValue - get last visible value of the array 

♦ InGICS - check if given symbol belongs to specified GICS category 

♦ GicsID - get information about GICS category 

♦ PlaySound - play .WAV sound file 

♦ ShellExecute - execute external program / file 

♦ _DT - synonym of StrToDateTime 

• Quote Editor improvements and fixes: allows user to turn on/off time shift and editing timestamps 
down to milliseconds, fixed handling of 12 hour (AM/PM) regional setting 

• Charting improvements: better looking value labels, low-level gfx functions speeded up 4 times. 

• Charting-related changes 

♦ Data Window and data tooltip readout is immediate and does not require extra AFL execution 
(values required to display them are stored in RAM during normal chart refresh and available 
without need to re-run the formula). Tooltip variable is now obsolete. To display custom 
values in tooltips without plotting a line you can use Plot() with styleHidden flag. 

♦ Interpreation display does not require AFL execution 

♦ Inserting indicator and resetting parameters are orders of magnitude faster 

♦ chart zoom setting is now saved in a layout file and restored when layout is loaded 

• OLE interface improvements (new IsBusy method of Analysis object and Import method refreshes Ul 
automatically) 

• AFL engine improvements: 

♦ added warnings that detect potential user mistakes - such as assignment within conditional 
expression or redundant calls to Plot() function 

♦ added extra checks for invalid parameter values for many functions and array subscript == 
Null - appropriate error message is displayed 

♦ PlotText optimized to conserve memory and reduce execution time by skipping invisible parts 

• Account manager fixes 

• improved compatibility with Windows 7 (high-DPI aware manifest, compatibility with Internet Explorer 

9) 

• 64bit-specific fixes (including fixing problems with 3rd party DLLs) 

• new appearance themes and many other improvements and fixes 

Highlights of version 5.30 

• changed database format to support time stamp granularity down to one microsecond (0.000001s) 
and more data fields 

• static array variables 
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• user-definable backtest report charts (see examples in Charts window, "Report Charts" folder) 

• new Data Window (Window->Data Window) 

• new Performance Monitor tool 

• tick statistics added to Time&Sales window 

• chart blank area extension using END key (on the keyboard), to restore original setting press HOME 
key 

• added option to require variable declarations (SetOption("RequireDeclarations", True )); 

• persistent column state (widths/order/visibility) in the Automatic Analysis and all other list-views. 

• gradient area charts capability (see Charts - Basic Chart - Gradient Price chart) 

• new typeofO AFL operator 

• new AFL functions 

♦ ColorBlend 

♦ DateTimeDiff 

♦ HighestVisibleValue 

♦ LowestVisibleValue 

♦ StaticVarCount 

• User-definable Z-order of drawings and indicator plots 

• optional data padding for non-trading days 

• Rectangle and ellipse drawing tools are now solid by default 

• X-Y co-ordinate labels added (use View->X-Y Labels menu to display/hide). 

• Support for SSL (secure connection) and TCP/IP port selection for e-mail alerts added 

• new Symbols window with ultra quick full-text search and sorting 

• support for GICS 4-level category system 

• placing orders directly from chart (Interactive Brokers) 

• many other improvements and fixes (see Release Notes document for details) 

Highlights of version 5.20 

• Smart (non-exhaustive) trading system optimization 

AmiBroker now ships with 3 non-exhaustive, evolutionary optimization algorithms: 

SPSO (Standard Particle Swarm Optimizer) 

TRIBES (Advances Particle Swarm) 

CMA-ES (Covariance Matrix Adaptation Evolutionary Strategy 

• Support for market-neutral, long-short balanced strategies via MaxOpenLong/MaxOpenShort 
control and separate long/short rankings in the backtester 

• Performance optimizations in chart drawing engine - charts are orders of magnitude faster when 
number of bars displayed is much greater than number of pixels. 

• Log window implemented - allow tracing and run-time error reporting 

• QuickAFL implemented in the Automatic Analysis - speeds up backtests, optimization and 
explorations by factor of 2 or more (if range is less than all quotations). (Note: in order to enable it you 
need to check "Use QuickAFL" box in the Automatic Analysis setttings). 

• Multiple-segment Volume-At-Price charts (via PlotVAPOverlayA function) 

• 32-bit AmiBroker is now LARGEADDRESSAWARE, i.e. can now use upto 4GB of RAM 

• Built-in Quarterly and Yearly intervals 

• Automatic summary rows in the explorations (via AddSummaryRows AFL function) 

• Charting enhancements and improvements 

♦ better handling of drawing tools 

♦ better magnet mode 

♦ Fibonacci timezones now include lines 144 and 233 

♦ zooming via scroll bar improved 
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• Range bars now use per-symbol TickSize as a unit 

• new AFL functions: 

GetChartBkColor 

CategorySetName 

PlotVAPOverlayA 

AddSummaryRows 

DaysSince1900 

OptimizerSetEngine 

OptimizerSetOption 

StrCount 

• AFL performance improvements in LinearReg, LinRegSiope, Lin Reg Intercept, TSF and StdErr, Day(), 
Month(), Year(), DaysSince1900(), DayOfWeek(), DayOfYear() functions (order of magnitude faster) 

• Improved AFL functions: queued Say() command (text-to-speech), improved StrExtractQ - can now 
refer to items counting from the end 

• reai-time data piugins updated (IB version 1.2.4, eSignai version 1.9.0), IBControiier updated to 
support iatest changes in data sources 


Highlights of version 5.10 

• Automatic Walk-Forward testing (trading system optimization and vaiidation technique) 

• Floating windows (TRUE muiti-monitor charting capabiiity) 

abiiity to "undock" (or "fioat") the chart window and move it to separate monitor. 

Aii iayout code is aiso updated to correctiy save and restore muiti-monitor chart setups 
http://www.amibroker.com/video/FioatAndLink.htmi 

• Symbol and Interval linking 

multiple charts can now be linked by symbol and/or by interval using easy-to-use color-coded links 

• AFL Code Profiler - shows code analysis with detailed per-function timing report (AFL Editor: 

Tools->Code Check & Profile menu) 

• Real-time quote window improvements 

♦ re-ordering of symbols in the RT quote using drag-and-drop 

♦ direct type-in symbols into RT quote window 

♦ ability to separate groups of symbols by inserting empty line 

♦ faster refresh and multi-stage background color fading on quote change 

• new/improved AFL functions 

♦ (new) SetBarFillColor 

♦ (improved) GetCursorXPosition 

♦ (improved) GetCursorYPosition 

♦ (improved) GetCursorMouseButtons 

♦ (improved) SetChartOptions 

♦ (improved) SetOption 

♦ (improved) Status 

• Improved speed of backtesting/optimization (up to 2x in some cases as compared to v5.00) 
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• improved chart crosshairs - no fiicker, work faster and can be switched on/off giobaiiy 

• track more foreign markets: now you can define rates for up to 20 currencies (different than base 
currency) for muitipie currency backtesting in the preferences window. 

• new backtester modes: backtestReguiarRaw2 and backtestReguiarRaw2Muiti 

• new FindSignal method of backtester object 

• 3D optimization chart animation is now smoother (lOOfps) 

• uniimited nesting of #inciude and #inciude_once statements 

• Improved scaiing of semi-iog charts, MDI tab order saved in the iayout, improved bug reporting, high 
resoition Vista icon added, other fixes and improvements 

Highlights of version 5.00 

• New Watchiist system featuring: 

♦ uniimited number of watch lists 

♦ lists keep original order in which symbols were added (still can be sorted alphabetically 
on-demand) 

♦ new AFL function to refer to watch lists by name 

• Support for AFL Code Wizard - brand new automatic formula creation program for people without 
any programming experience. For more information about AFL Code wizard see this introductory 
video: http://www.amibroker.com/video/amiwiz/AFLWiz1 .html 

• AFL engine enhancements 

♦ new flow control statements: switch /case / break / continue 

♦ new compound assignment operators: -i-=, -=, *=, /=, %=, &=, |= 

♦ new functions: GetPlaybackDateTime(), PopupWindow(), Mersene Twister Random Number 
Generator mtRandom(), and others 

• New dedicated memory heap allocators for quotes and trading system signals resulting in ability to 
run much longer optimizations than ever without getting out-of-memory messages 

• Two new backtester modes (available using SetBacktestMode function) allowing handling of unfiltered 
(raw) entry signals 

• User-definable 5-tier commission schedule in the backtest (Automatic Analysis / Settings) 

• Chart template sharing 

now you can save the chart as "Chart Template, Complete (‘.chart)" that stores all layout AND 
referenced formulas in SINGLE file that can be sent to your friend and entire chart will be restored on 
any computer with ease, without need to copy individual formulas. 

• New-Look charts - divider lines between panes are now single pixel and no borders around charts 
giving cleaner, larger and more readable chart display and printout 

• Custom Range Bars (supported in the charts and via TimeFrameSet()) 

• New Low-level graphics interface (23 new AFL functions) 

• HTML Import in Automatic Analysis 

• Full screen Anti-Aliasing in 3D optimization chart viewer (beautifully smooth 3D charts and improved 
readability) 

• Enhanced Real-Time Quote window display (faster updates, dual-color change marks) 

• Control of Time Shift in the ASCII importer 
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Detailed Change Log 

CHANGES FOR VERSION 6.00.0 (as compared to 5.99.0) 

• AFL Editor: Preferences: the default value for "Auto-complete" changed to "Immediate" 

• AFL: MxGetSize( matrix, dim ) - get matrix size in given dimension 
where 

matrix argument is matrix to query for the sizes 

dim argument is 0 or 1.0 gets number of rows, 1 gets number of columns. 

MxGetSize( matrix, 0 ) - gives number of rows 
MxGetSize( matrix, 1 ) - gives number of columns 

• AFL: Mxldentity( size ) - creates an indentity matrix of defined size (square matrix with rows and 
columns equal to size argument filled with ones on the main diagonal and zeros elsewhere) 

• AFL: MxTranspose( matrix ) - creates transpose of an input matrix 

• AFL: Warning 506 is suppressed when formating is 1.0 (integer) 

CHANGES FOR VERSION 5.99.0 (as compared to 5.98.0) 

• AFL: added support for matrices (2D tables of numbers). 

Matrix support is preliminary and subject to change. 

To create a matrix use 

my_var_name = Matrix( rows, cols, initvalue) 

To access matrix elements, use: 
my_var_name[ row ][ col ] 

where 

row is a row index (0... number of rows-1) 
and 

col is a column index (0... number of columns-1) 

Matrices and their elements support all scalar (element-wise) arithmetic and logical operations 

So you can for example add, subtract, multiply, divide two matrices if they have same dimensions with 
one call. 

X = Matrix( 5, 6, 9 ); // matrix 5 rows 6 columns, initial value 9 
y = Matrix( 5,6,10);// matrix 5 rows 6 columns, initial value 10 

z = y - z; // will give you matrix 5 rows and 6 columns filled with elements holding value 1 (difference 
between 10 and 9). 

All those operations are performed ELEMENT-WISE. 

You can also apply any arithmetic and logical operation on matrix AND scalar value. This would 
perform element-wise 

operation on each element of source matrix and given scalar value. 
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m = Matrix( 10, 10, 0 ); // m will be 10x10 matrix filled with zeros 
z = m; // z is now also a matrix 

for( I = 0; i < 10; i++ ) 

{ 

z[ I ][ 4 ] = i; // fill z with some other values, note that m will remain unaffected. 

} 

for( i = 0; I < 10; i++ ) 

_TRACEF( "%g = %g, %g, %g\n", i, m[i][1], m[ i][4], z[ i][4]); 

// scalar addition (element wise) 
z += 3; 
m += 5; 

for( I = 0; i < 10; i++ ) 

_TRACEF( "%g = %g, %g, %g\n", I, m[i][1], m[ i][4], z[ i][4]); 

Additionally there is a new operator @ that handles matrix product (matrix multiplication in the sense 
used in linear algebra). This operator requies 

that number of columns in first array is the same as number of rows in second array. 

• AFL: new Error 59. Too many subscripts - displayed when user attempts to use 3 or more subscripts 
on matrix identifier 

• AFL: new function Matrix( rows, cols, init_value = 0 ) - creates 2 dimensional table with defined 
number of rows and column 

• AFL: new matrix product (multiplication) operator: @ 

a new operator @ that handles matrix product (matrix multiplication in the sense used in linear 
algebra). This operator requires 

that number of columns in first array is the same as number of rows in second array. 

A = Matrix( 1,3); 

B = Matrix( 3, 2 ); 

// matrix A = [ 1,4, 6 ] 

// matrix B = [ 2, 3 ] 

// [ 5, 8 ] 

// [ 7, 9 ] 

A[0][0] = 1;A[0][1 ] = 4;A[0][2] = 6; 

B[0][0] = 2;B[0][1 ] = 3; 

B[1 ][0] = 5;B[1 ][1 ] = 8; 

B[2][0] = 7;B[2][1 ] = 9; 

X = A@ B; 


_TRACEF("%g %g", X[ 0 ][ 0 ], X[ 0 ][ 1 ]); 

• Charts: when chart is moved vertically by the user so it falls outside upper edge, the parts falling 
outside are not drawn as flat line anymore 

• New Analysis: Attempt to run Walk forward on periods without any data for any symbols could result 
in exception. Fixed. 

• New Analysis: Show current trade arrows did not show sell arrow after Individual backtest. Fixed. 
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• Ul: Color text output in the Interpretation window was sometimes incorrect when numbers followed 
immediately EncodeColor call. Fixed. 

• Ul: Interval combo dropdown list adapts its width to higher DPI displays now 

• Ul: Notepad is refreshed on sliding back from auto-hide 

• Ul: Updating Symbol Information after ASCII import 

• Upgrade info: Free upgrade only for users who purchased license after May 31,2013 

CHANGES FOR VERSION 5.98.0 (as compared to 5.97.0) 

• Analysis: Monte Carlo CDF charts use denser X grid (5% stepping) 

• Analysis: Monte Carlo min/max/avg equity charts can now be displayed as percent change instead of 
absolute values 

• Analysis: Monte Carlo stats are now generated in out-of-sample Walk forward steps by default 

• Analysis: Walk forward Out-Of-Sample summary report includes Monte Carlo simulation from ALL 
trades of all Out-of-sample periods 

• Analysis: Walk forward: A crash could occur when Monte Carlo sim was enabled in walk-forward 
optimization. Fixed. 

• Analysis: Walk forward: Buy&Hold stats Max. sys drawdown was too large for 2nd and next steps of 
walk forward OOS. Fixed. 

CHANGES FOR VERSION 5.97.0 (as compared to 5.96.0) 

• Analysis: Backtest report uses now client-side script pagination when trade list contains more than 
1000 trades so it takes less time to display it (3s vs 15s for 30K trades). (Experimental, may be 
removed) 

• Analysis: MC: MC Min/Max/Strawbroom equit chart was getting slow when number of trades in 
backtest exceeded 1000. It draws faster now. 

• Analysis: Monte Carlo charts are now moved to Reports (so they appear in the REPORT as a 
separate page, not as tabs in Analysis) and generated in separate thread 

• Analysis: Monte Carlo: numerical values of distributions are now included in the Report / Monte Carlo 
page 

• HtmIView: new version 1.3, improved performance of Edit->Copy Table for large tables (>30K rows) 
by 2 orders of magnitude. Also added support for paginated tables. 

• In 5.9x single-symbol portfolio backtests were reported as "0-symbols" in Report Explorer. Fixed (fix 
applies to newly run backtests only) 

• OLE: added LoadWatchlists() method to Broker.Application object. It allows to re-load watchlist files 
for currently loaded database without re-loading entire database. (Just in case you ask for 
SaveWatchlists - watchlists are saved when you call SaveDatabase) 

• OLE: splash screen closes automatically after 1 second if program was launched from OLE, instead 
of being displayed as long as OLE object is active 

• Ul: Added global Analysis->Report Explorer menu to access Report explorer without need to open 
Analysis window 

• Ul: small tweaks and fixes to About/Splash screen. 

CHANGES FOR VERSION 5.96.0 (as compared to 5.95.0) 

• AFL Editor: Verify Syntax uses raw symbol quotes, so it is faster and works regardless of "mixed 
data" setting 

• AFL Editor: Word wrap - wrapped lines uses same indent as previous line 

• AFL: added SetStopPrecedence function 

• AFL: ApplyStopO has 2 more parameters: ValidFrom/ValidTo - define starting and ending bar since 
entry when stop is active 
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//Applystop( type, mode, amount, exitatstop, volatile, reentrydelay, validfrom, validto ) 

ValidFrom - defines first bar since entry when stop can generate an exit. 0 means from the very 
beginning 

ValidTo - defines last bar since entry when stop can generate an exit. -1 means "infinite". 

By default stops are valid all the time (0/-1). 

So now you can create stops that get actived/deactivated in different times. 

This setting is independent for each stop type. It also works in conjunction with 
SetOption("HoldMinBars", x). 

HoldMinBars affects BOTH regular exits and stops, preventing ALL kind of exits during defined 
period. 

ValidFrom/ValidTo works on each stop separately and does not affect regular exits. 

For example always have a stopTypeLoss always in affect and only allow a trailing stop to become 
active after so many bars: 

ApplyStop(stopTypeLoss, stopModePercent, 10, 1); 

ApplyStop(stopTypeNBar, stopModeBars, 40, 1); 

ApplyStop(stopTypeTrailing, stopModeRisk, 7, True, True, 0, 4 /* valid from 4th bar after entry 7); 

This feature is extended implementation of FC item #514 

IMPORTANT: 

Precedence parameter introduced in 5.95 has been REMOVED. 

That functionality has been replaced by new SetStopPrecedence function. 

• AFL: new function: _TRACEF() - printf-formatted trace 
_TRACEF( "Close %g. Open %g". Open, Close ); 

• AFL: Param() offers increased stepping precision for small fractional increments 

• Analysis: some newly introduced settings (MC mainly) were not saved in Analysis project. Now they 
are saved. 

• In 5.95.0 formulas 0, 1, -1, Null constants for Buy/Sell/Short/Cover assignments and using Equity() 
could crash. Fixed. 

• In 5.95.0 when ExitAtStop==1 for NBarStop was used it deactivated other stops in backtestRegular 
mode. Fixed. 

• In backtestRegular mode (old code path) when HoldMinBars was >=2 and exit was triggered on very 
first bar opening after hold period price was not adjusted to open as in other (new) backtest modes. 
Fixed. 

• Monte Carlo: MC can be now enabled in Optimization and Individual Backtest 

To enable Monte Carlo simulation in each backtest of optimization process and each individual 
backtest you can use 

SetOption( "MCEnable", 2 ); // value == 2 forces MC to be enabled everywhere (in every mode 
including optimization). 

the old option: 

SetOption("MCEnable", 1 ); //value == 1 enables MC only in portfolio backtests (default) 

Note that enabling MC in optimization is highly discouraged unless you actually use MC metrics as 

optimization target via custom backtester 

or otherwise use MC distributions in the optimization process. 
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Monte Carlo process is computationally costly and while few hundred milliseconds added to one 
backtest don't matter much, 

in case of optimizations when these are multipled by number of steps you can easily increase 
optimization time by orders of magnitude. 

So unless you REALLY need MC distribution as custom metric and optimization target, do NOT 
enable MC in optimization. 


• Ul: added special "meaningful" message on attempt to open the .APX file that has invalid format 

• Ul: Analysis settings are now made newbie-friendly - a new "SCENARIO" combo has been added that 
allows to choose from 4 preset scenarios 

If user chooses preset scenario, the application sets properly the following fields 

- trade prices & delays 

- exitAtStop modes 

- N-bar stop priority 

- ActivateStopImmediately 

and disables those preset controls from accidential change. 

Using presets prevents beginners from using wrong settings. 

It is still possible to override any setting from the formula level (so be careful what you write in your 
formula). 

A default "CUSTOM" scenario works as in old versions -i.e. all fields are enabled for change but it is 
user responsibility 

to set those fields properly. Flexibility comes at a cost - some combinations of settings that are not 
covered by preset scenarios 

may make no sense and sometimes lead to wrong results. The user should consult the manual and/or 
ask support when in doubt. 


• Ul: Analysis Settings: "Activate stops immediately" check box has been moved from "General" to 
"Stops" tab where it really belongs functionally 

• Ul: new About dialog/startup splash screen (asynchronously showing app loading info) 

• Ul: Parameter window: when parameter names are very long, value area is shrinked down to give 
more space for name, but not less than 160px/96DPI 

CHANGES FOR VERSION 5.95.0 (as compared to 5.94.0) 

• AFL Editor: Pretiffy formatting fixes and improvements. Also editor attempts to keep unchanged scroll 
position after prettify. 

• AFL Editor: Prettify selection now removes extra padding around parenthesis and leaves only one 
space pad inside 

• AFL Editor: Word wrap implemented (View->Word Wrap menu) 

• AFL Engine: upsizing certain common scalar values (-1,0,1, Null) to array is much quicker thanks to 
caching 

• AFL: #pragma maxthreads N - where N is a natural number 1 ...<number of cores>. Allows to lower 
the number of parallel threads using in Analysis. For example to run in just one thread use #pragma 
maxthreads 1 

Attention: lowering number of threads degrades performance 
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• AFL: ApplyStop has new, 7th parameter: precedence that defines the order in which stops are 
triggered if they appear on the very same bar 
Accepted vaiues are 0,1,2, 3. 

Stops are executed in increasing precedence order, so 0 is executed first, 1 - second, 2 - third, 3 - as 
the iast. 

Vaiues outside 0..3 range are ignored. 

Specifying -1 means "no change" - use defauit order. 

Keep in mind that if you are changing AppiyStop order/precedence you 

1. MUST DEFINE ALL APPLYSTOP even if you don't use aii stop types. It you don't use given stop 
type use stopModeDisabie in mode parameter 

2. There must be NO DUPLICATE in precedence numbers. Otherwise unpredictabie behavior may 
occur. 

3. The order of events inside bar is unknown so specifying given order of execution of stops 

is based on assumptions that may or may not be correct for given trading scenario. It is advised to 
keep max. ioss stop as first one. 

Whenever N-bar stop is executed first or not depends on your trading setup. If you trade on open, 
then Nbar stop may be executed first (even before max ioss). 

Traiiing stop can be excuted before or after profit target depending on your setup. Contrary to "gut 
feeiing" executing traiiing stop before profit target is not necesariiy more pessimistic, because 
in severai cases ieads to increasing CAR instead of decreasing it. Now you can test both. Choose 
whatever fits your trading styie. Choo 


Exampie: 

// Appiystops wiii be excuted in the foiiowing order: ioss, traiiing, profit, n-bar: 

AppiyStop( stopTypeLoss, stopModePercent, 5, True, Faise, 0, 0 /*precedence7); 

AppiyStop( stopTypeTraiiing, stopModePercent, 5, True, Faise, 0, 1 /‘precedence*/); 

AppiyStop( stopTypeProfit, stopModePercent, 5, True, Faise, 0, 2 /‘precedence*/); 

AppiyStop( stopTypeNBar, stopModeBars, 40, Faise, Faise, 0, 3 /‘precedence*/); 

Note: 

for backward compatibiiity: 

With StopTypeNBar, when Precedence parameter is provided then ExitAtStop setting is ignored. 
When Precedence parameter is not provided for stopTypeNBar 
there are two possibie sequences appiied by defauit 

if NBarHasPriority setting is true or you caii AppiyStop with ExitAtStop set to true then sequence is 
N-bar, ioss, profit, traiiing 

otherwise defauit sequence is ioss, profit, traiiing, N-bar 

These defauits wiii be re-appiied whenever you caii AppiyStop( stopTypeNBar...) without providing 
precedence parameter. 

Note 2: 

Fixed ruin stop (99.6% ioss) is aiways executed as iast one. 

• AFL: Custom Backtest: Monte Cario simuiation resuits are now avaiiabie in custom bactester (after 
backtest or PostProcess()). 

per = Optimize( "period", 20, 2, 100, 1 ); 

Buy = Cross( C, MA( C, per)); 

Seii = Cross( MA( C, per) , C ); 
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SetOption("MCEnable", True ); 

SetOption("MCRuns", 1000 ); 

SetPositionSize( 1, spsShares); 

SetCustomBacktestProc(""); 

if( Status("action") == actionPortfolio ) 

{ 

bo = GetBacktesterObjectO; 

bo.BacktestO; // run default backtest procedure 

// get access to Monte Carlo results 

// note 1: It may be NULL If MC Is NOT enabled 

// note 2: MC results are available after Backtest() or PostProcess as MC simulation Is done In final 
phase of post processing 
me = bo.GetMonteCarloSImO; 

lf( me) 

{ 

// get 25-th percentile of final equity distribution 
bo.AddCustomMetrlc("FlnalEq25", mc.GetValue( "FInalEquIty", 25 )); 

} 

} 

• GetMonteCarloSimO to retrieve MC object to access distributions 
MonteCarloSIm object: 

Methods: 

GetValue("fleld", percentile) 

• AFL: MonteCarloSim GetValue( "field", percentile ) 

Available "field" values: 

" FInalEquIty" 

" CAR" 

" LowestEquIty" 

" MaxDrawdown" 

" MaxPercDrawdown" 

• AFL: new function: MR - general-purpose Infinite Impulse Response filter of order 1-4 
IIR( Input, bO = 1, a1 = 0, b1 = 0, a2 = 0, b2 = 0, a3 = 0, b3 = 0, a4 = 0, b4 = 0 ) 

It Implements fast 4th-order Infinite Impulse response filter. 

Analytically It Is: 

y[ n ] = bO * x[ n ] -r b1 * x[ n - 1 ] -r b2 * x[ n - 2 ] -r b3 * x[ n - 3 ] -r b4 * x[ n - 4 ] 

-I- a1 * y[ n -1 ] -i- a2 * y[ n - 2 ] -i- a3 * y[ n - 4 ] -i- a4 * y[ n -4 ]; 

AFL equivalent: 

y = x; // Init so no glitches at the beginning appear 
for( n = 4; n < BarCount; n-i-i-) 

{ 

y[ n ] = bO * x[ n ] -r b1 * x[ n - 1 ] -r b2 * x[ n - 2 ] -r b3 * x[ n - 3 ] -r b4 * x[ n - 4 ] 

-I- a1 * y[ n -1 ] -i- a2 * y[ n - 2 ] -i- a3 * y[ n - 4 ] -i- a4 * y[ n - 4 ]; 
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} 

Filters of orders 3 and 2 can be implemented by leaving unneeded arguments at default value of zero. 

Coefficients bO, b1, b2, b3, b4 multiply the input signal x[n] and are referred to as the feedforward 
coefficients. Coefficients a1, a2, a3, a4 multiply the output signal y[n] and are referred to as the 
feedback coefficients. Pay careful attention to the sign of the feedback coefficients. Some design tools 
flip the sign of the feedback coefficients. In this case the feedback coefficients must be negated. 

This convention is used so feedback coefficients work the same as in AMA2 in case of first order filter, 
so 

IIR( array, factor, 1-factor) 
is the same as 

AMA2( array, factor, 1 -factor) 

(with very minor difference is that MR uses internally double precision arithmetic while AMA2 uses 
single precision) 

simple ema: 
factor = 2/(periodH-1); 

IIR( input, factor, 1- factor); 

Wilders: 

factor = 1/period 

IIR( input, factor, 1-factor); 

Ehlers Supersmoother 


Pe 

riods 

= 10; 


cl 

= 1.4 

1421 

* 3.14159 / Periods; 

c2 

= 2.7 

1828" 

-cl; 

al 

= 2 * 

c2 * 

cos ( cl ); 

a2 

= -c2 

"2; 


bO 

= (1 

- al 

- a2)/2; 

bl 

= bO; 



X 

= IIR( 

Close, bO, al, bl, a2 ); 

Plot ( X, 

"Super Smoother", colorRed 


• AFL: SetOption/GetOption new fields for MC Equity/Straw broom chart, "MCChartEquityCurves" 
(true/false), "MCStrawBroomLines" (0..100), MCPosSizePctEquity (0..100) 

• AFL: Status("ThreadlD") - gets the current thread ID under which formula is executed 

• Analysis: MCS: new position sizing method: Percent of Equity 

• Backtest: fixed ruin stop (99.6% drawdown) in backtestModeRegular is executed last as in other 
modes now. 

• Memory usage was larger in 5.94 when lots of chart panes were open. Now it is back to previous 
levels. 

• MonteCarlo: Min/Max/Avg Equity -i- Straw broom chart implemented -i- Settings 
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• Ul: Enhanced Assignment Organizer: Faster operation, dispiay FULL NAME aiongside with symboi, 
sorting by coiumn, aiternate row background, proportionai resizing of both ieft/right iists 

CHANGES FOR VERSION 5.94.0 (as compared to 5.93.0) 

• Anaiysis: impiemented Monte Cario simuiation (preiiminary) produces CDF charts of MC Finai Equity, 
MC CAR, MC Max Drawdown $ and %, Lowest Equity 

This feature is preiiminary and subject to change. 

AmiBroker's buiit-in Monte Cario simuiator is high speed (30+ miiiion trades per second) simuiator 
that runs series of random trade sequences based on backtest output. 

It uses high-quaiity Mersene Twister random number generator. 

It is run automaticaiiy after backtest and produces a series of CDF charts (see extra tabs in the New 
Anaiysis window). These charts are probabiy going to be moved 
to the report at iater stage. 

Monte Cario simuiator is by defauit avaiiabie oniy during portfoiio backtest runs. It is NOT 
avaiiabie/running during optimization or individuai optimization. 

(I may enabie it in the future). 

You can controi process of Monte Cario simuiation using new Settings page: 

"Enabie Monte Cario Simuiation" - turns on/off MC simuiator 

"Number of runs" - defines how many MC simuiation runs is done (defauit 1000) 

"Position sizing" - defines position sizing used by Monte Cario simuiator. 

Position sizing aigorithm used by MC process is independent from that used by backtest. To do so 
MC may appiy speciai processing to trade iist obtained from backtester depending on this option 
setting. 

- "Don't change" - uses trades as they are coming from the backtester without changing position size 
and profit as it is reported from the backtester 

- "Fixed size: N shares/contracts" - trade fixed number of shares/contracts. It takes per-share profit as 
reported by backtester and muiipiies it by N contracts as entered in the settings. Per-share profit is 
caicuiated by dividing profit reported by the backtester by number of shares/contracts reported by the 
backtester 

- "Constant vaiue: X" - trades fixed amount per trade. Takes percent profit reported by backtester and 
muitipiies it by constant vaiue entered to get the profit. 

• AFL: SetOption/GetOption support new fieids that controi Monte Cario simuiation: "MCEnabie" 
(true/faise), "MCRuns" - defauit 1000, "MCPosSizeMethod" - 0 - don't change, 1 - fixed size, 2 - 
constant amount, "MCPosSizeShares" (number), "MCPosSizeVaiue" (number) 

• AFL: 32-bit round() is 7X faster and now works in "round haif to even" (defauit IEEE mode) instead of 
haif towards infinity. Hand written in assembiy due to siowness of CRT 

• AFL: into and frac() functions are 2X faster now 

• AFL: integer division operator \ (experimentai) 

• AFL: StrMatchO - string pattern/wiidcard matching 
StrMatch( "sting", "searchsting"); 

returns TRUE or FALSE whenever string matches searchstring or not. 
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Searchstring is can contain wiid-card characters such as: 

* - matches any string, inciuding empty strings 
? - matches any singie character 

This function is case sensitive (of course except wiidcard characters). 

if you want case insensitive matching - convert both string and searchstring to iowercase or 

uppercase 

prior to matching (StrLower/StrUpper) 

Exampie: 

X = StrMatch("Every breath you take", "Every * you *"); // x wiii be TRUE 
X = StrMatch("Every step you make", "Every * you *"); // x wiii be TRUE 
• AFL: support for UCN (universai character numbers) \uXXXX where XXXX is hexadecimai character 
code. UCN output works in PiotText/PiotTextSetFont, GfxDrawText, GfxTextOut, Chart tities, 
interpretation and Commentary windows. Requires Windows 2000 or higher 


For exampie 
heart "\u2764" 
sun "\u2600" 
star "\u2605" 

EURO currency: "\u20ac" 

Sigma (greek): "\u03a3" 
aipha (greek): "\u03b1" 
beta (greek): "\u03b2" 
umbreiia: "\u2602" 
teiephone: "\u260e" 
hand pointing up "\u261D" 

Tabies of aii UCN/Unicode characters 
http://www.unicode.org 
http://unicode-tabie.com/ 
http://www.unicodemap.org 

http://en.wikipedia.org/wiki/List_of_Unicode_characters 
Various arrows: 

http://www.unicode.org/charts/PDF/U2190.pdf 
Enciosed aiphanumerics: 
http://www.unicode.org/charts/PDF/U2460.pdf 

(note: NOT aii giyphs (graphicai representations of characters) are actuaiiy present in current font. 
This depends on your operating system. For exampie Segoe Ui in Windows 7 has iots of characters, 
but Windows 8 has more, 

if a giyph is missing usuaiiy an empty rectangie is drawn). DejaVu free font has iots of giyphs, 
Symboia free font has iots of weird shapes. 

Piot( C,coiorDefauit); 

PiotTextSetFont( "\u2665\u2126\u2191\u21d1\u24ee\u261 D", "Segoe Ui", 30, 20, 
HighestVisibieVaiue( C )/2 + LowestVisibieVaiue( C )/2 , coiorRed ); 

Titie = "A demo of UCN: 

"-rEncodeCoior(coiorRed)-r"\u2665\u2126\u2191\u20ac\u03a3\u03b2\u2602\u260E"; 

• Ui: Charts: when creating a new chart window intervai Lock was often marked automaticaiiy. Now it is 
fixed (it is aiways OFF for new charts). 

• Ui: XY-charts couid enter infinite ioop (hang) if ALL Y-coordintates were the same. Fixed. 
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• Ul: XYCharts tooltip display shows XA' point data under the cursor as in old version but when it does 
not find any, it shows data point from relevant X position 

CHANGES FOR VERSION 5.93.0 (as compared to 5.92.0) 

• AFL Editor provides precise positioning of cursor for errors that occur within argument list of function 
calls 

• AFL: Error 5 (incorrect type of argument in function call) is now much more precise: it tells what 
function expects and what type is actually found 

• AFL: Low Level Gfx: GfxSelectStockObject() added - allows to select so called "stock" GDI objects 
such as Hollow brush (that allow to draw empty circles, polygons and so on) 

Available stock objects: 

WHITE_BRUSH 0 
LTGRAY_BRUSH 1 
GRAY_BRUSH 2 
DKGRAY_BRUSH 3 
BLACK_BRUSH 4 

NULL_BRUSH 5 (the same as hollow brush) 

HOLLOW_BRUSH 5 
WHITE_PEN 6 
BLACK_PEN 7 
NULL_PEN 8 
OEM_FIXED_FONT 10 
ANSLFIXED_FONT 11 
ANSLVAR_FONT 12 
SYSTEM_FONT 13 
DEVICE_DEFAULT_FONT 14 
SYSTEM_FIXED_FONT 16 
DEFAULT_GULFONT 17 

Example circle with hollow interior: 

GfxSelectPen( colorOrange, 4); 

GfxSelectStockObject( 5 ); // hollow brush 
GfxCircle(100, 100, 20 ); 

• AFL: Low-Level Gfx: GfxSelectHatchBrush( color, style ) 

Supported hatch styles: 

HS_HORIZONTAL 0 /* —- 7 
HS_VERTICAL 1 /* ||||| 7 
HS_FDIAGONAL 2 /* \\\\\ 7 
HS_BDIAGONAL 3 /* Hill 7 
HS_CROSS 4 /* -r-r-r-r-H 7 
HS_DIAGCROSS 5 /* xxxxx 7 

Hatch color is specified by color parameter, hatch background is specified by current background 
color 

see: GfxSetBkColor() 

GfxSelectPen( colorOrange, 4); 

GfxSetBkColor( colorLightGrey); 
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GfxSelectHatchBrush( colorBlue, Param("Hatch pattern", 5, 0, 5 )); 
GfxCircle(100, 100, 20 ); 


• AFL: Low-level Gfx: GfxSetZOrder now supports using z-order outside -5...-I-5 range, but displays a 
warning 903 In the editor about possible decrease In performance 

• AFL: PercentIleO function now supports variable period and has default value for rank = 50 (such 
param gives median with average of upper/lower median for even periods) 

Note that Percentile Is very computation Intensive function (It Involves re-sorting arrays every bar) 
and variable-period version (If you call It with period being ARRAY) runs slower than scalar version 

bl = BarIndexO; 

X = Percentlle( Close, bl, 50 ); 

Plot( X, "Cumulative 50% Percentile", colorRed ); 

Plot( Close, "Price", colorDefault, styleCandle ); 

• AFL: XYAddChartPoInt has new parameter (llnecolor) 

• AFL: XYChartSetAxIs now supports the following styles: styleLlne, styleDots, styleHlstogram, 
styleThIck and combinations of those styles. Multiple lines are possible - to start a new line call add a 
NULL point - XYAddChartPolnt( chartname,Null, Null); 

chartname="example"; 

XYChartSetAxls(chartname, "[x]", "[sinx/x]", styleLlne | styleDots ); // bar style 
for( X = -10; X < 10; X -1-= 0.2 ) 

{ 

y = sln(x ) / x; 

XYChartAddPolnt( chartname, x, y, colorGreen, colorRed ); 

} 

XYChartAddPolnt( chartname, Null, Null); // add a NULL point to begin new line 

for( X = -10; X < 10; X -1-= 0.2 ) 

{ 

y = sln( 2 * X ) / x; 

XYChartAddPolnt( chartname, x, y, colorOrange, colorBlue ); 

} 

• Backtest: Buy-And-Hold simulation Is performed and Its statistics are calculated and Included In the 
Backtest Report. 

This feature In worst case (single symbol test) may add upto 30% to backtest time. In portfolio case 
the Impact Is negligible. 

The Buy-and-Hold calculations are turned OFF when detailed reports are not generated, for example 
during optimizations, so there Is no slow down, 

unless you turn on report generation during optimization SetOptlon("GenerateReport", 1 ) 

You can turn It off from Settings, Reporting 

Buy-and-hold simulation uses current symbol when doing single-symbol backtests/optimizatlon. 
When doing portfolio backtest for more than one symbol. It uses "Portfolio B&H symbol" as a 
benchmark for buy and hold. 

• Backtest: Report: numerical values don't get wrapped when report window Is made small 
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• Backtester: implemented user-definable interest on account margin loans, charged when net cash 
balance drops below zero. Margin rate (0..100%) is definable in Analysis Settings. 

Margin Rate is added ON TOP of interest rate defined in the settings. 

So if interest rate is set to 0.1% and Margin rate is 1%, then effective margin loan rate is 1.1%. 

It also works with dynamic Interest rate, so if you define dynamic Interest Rate symbol 
then Margin Rate is added ON TOP current value taken from dynamic Interest Rate 

Current rates used are listed in the Detailed Log 

• Backtester: implemented variable interest rate earnings 
To use variable interest rate: 

1. Add a symbol that will hold interest rates. It does not need to have quotes every day, 
you can have only quotes on days when interest rate changes. 

Interest rates should be expressed in PERCENTS. So if interest is 5% you should enter 5 in "close" 
price field for particular date 

2. Enter the rate symbol into "Dynamic interest symbol" in the Settings. 

3. Enter "Fixed interest rate" in the Settings. It will be used for days PRIOR to very first date available 
in intrest rate symbol. 

• Backtester: interest earnings on positve cash balance and deductions on margin loans are now 
reported in detail in "Detailed log" mode every day 

• Filter window enhanced. Now you can select multiple categories of the same type (for example even 
7 different watch lists) and combine them using "OR" (match ANY), or "AND" (match ALL) 

• Ul: Commentary: added marquee progress bar to give visual clue to the user when formula is being 
executed 

• Ul: Deletion of symbols is now confirmed with better looking task dialog that has explicit button "Yes, 
delete permanently" to avoid user mistakes 

CHANGES FOR VERSION 5.92.0 (as compared to 5.91.1) 

• Analysis: Exploration's XYChart now allows bar style in addition to point style. 

• AFL: New argument for XYChartSetAxis("chartname", "xaxis", "yaxis", chartStyle = 0 ) 

Note that XY chart styles are different than regular chart styles and only two are supported at the 
moment: 0 (default) - point style, 1 - bar style (new) 

Example of bar style usage (this is EXPLORATION code): 

chartname = "example"; 

XYChartSetAxis ( chartname, "[x]", "[sinx/x]", 1 ); // bar style 

for ( X = -10; X < 10; x += 0.2 ) 

{ 

Y = sin ( X ) / x; 

XYChartAddPoint ( chartname, x, y, colorGreen ); 

} 

Second example: 

chartname = "gaussian"; 

XYChartSetAxis ( chartname, "[x]", "[gaussian]", 1 ); 
for ( X = -3; x < 3; x += 0.125 ) 

{ 
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y = exp { - X '' 2 ) ; 

XYChartAddPoint ( chartname, x, y, IIf( abs ( x ) <= 1, colorGreen, 

colorRed ) ); 

} 


Bar style is useful for displaying probability distribution charts 


• AFL: SetChartBkColor did not change the background behind X-axis text. Fixed. 

• AFL: WriteVal/NumToStr has now new roundAndPad parameter that controls whenever function 
rounds output beyond 7th significant digit (and pads the rest with zeros), By default rounding is OFF 
now because it was off in 5.90 and earlier and rounding introduced in 5.91 could confuse old time 
users 

• AFL: WriteVal/NumToStr will display Warning 506 if specified format exceeds maximum IEEE 
precision (7 significant digits) and roundAndPad option is turned off 

• Analysis: 3D optimization chart was not available after Individual (MT) Optimization. Fixed. 

• Analysis: a faster Export to CSV routine in 5.91.0 caused memory leak. Fixed. 

• Analysis: Export to CSV could run out of memory when exporting more than 2GB. Fixed. 

• Log window shows correct path when using "Check AFL syntax" in the editor, especially helpful if 
error is inside included file 

• Log window: double clicking on error line brings up AFL editor and scrolls to error line / column 
automatically 

• PersistentVars.bin loading moved to AFTER CWD fix (prevents problem with deleting persistent 
variables when program is started with incorrect working directory) 

CHANGES FOR VERSION 5.91.0 (as compared to 5.90.1) 

• AFL/Charts: GfxSetCoordsMode( 1 ) now works with logarithmic scale too. 

• AFL: added "Warning 505. Division by zero" (level 2 warning). It detects divison by zero in arrays too 
and prints which array element was zero 

• AFL: failed COM type conversion is reported as a regular error within editor/log window instead of 
displaying message box 

• AFL: new field in SetOption("WarningLevel", x ); - allows to change warning level. Level 1 is default 
for all AFL executions with exception of AFL editor and commentary where warning level is set to 4 
Warning Level 

1 - report only level 1 warnings (502- too much plots) 

2 - report level 1 and 2 warnings (above plus assignment within conditional, division by zero, 
threadsleep period too long) 

3 - report level 1,2 and 3 warnings (above plus createobject/createstaticobject) 

4- report all warnings (default for the AFL editor) 

• AFL: new function AddRow("text") to add a raw text row to the exploration (allows outputing things 
without respecting Filter and without being limited to number of bars). This function is preliminary and 
its parameters are subject to change. 

SetOption ( "NoDefaultColumns" , True ); 

Filter = 1; 

AddColumn ( Close, "Columnl" ) ; 

AddColumn ( Null, "Column2" ) ; 

for ( i = 0; i < 10; i++ ) 

{ 
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AddRow ( StrFormat ( "row %g\tsecond column", i ) ) ; 

} 

• AFL: new functions SparseCompress( query_points, data ) /SparseExpand( query_points, data ) 

onlY_when = ( Month () % 2 ) == 0; // even months only 
X = SparseCompress ( only_when. Close ); // compact sparse data 
y = MA ( X, 10 ); // regular calculation 

y = SparseExpand ( only_when, y ); // expand sparse data 

Plot ( C, "Price", colorDefault, styleBar ); 

Plot ( y, "Sparse MA from even months", colorRed ); 


function SparseCompressEquiv( sparse_arraY, data_array ) 

{ 

result = Null; 
j = BarCount - 1; 

for ( 1 = BarCount - 1; 1 >= 0; i— ) 

{ 

if ( sparse_array[ i ] ) result[ j— ] = data_array[ i ]; 

} 

return result; 

} 

function SparseExpandEquiv( sparse_array, data_arraY ) 

{ 

result = Null; 
j = BarCount - 1; 

for ( 1 = BarCount - 1; 1 >= 0; i— ) 

{ 

if ( sparse_array[ i ] ) result[ i ] = data_array[ j— ]; 

} 

return result; 

} 

• AFL: NumToStr protected against user error of specifying precision higher than provided by IEEE 
standard (dispiay never exceeds 7 significant digits, rest is padded with zeros) 

• AFL: the engine dispiays more verbose error in case when GetArraySymboiCopy faiis 

• Anaiysis: CSV Export speeded up 100+ times. Now exporting iarge files takes seconds instead of 
hours. Export speeds on ordinary hard disks > 80MB/sec 

• Charts: Interval Lock added (so now you can lock symbol or interval or both) 

• Commentary window - warning level raised to 4 (report all warnings in commentary window) 

• Sort() could crash with IndexMode = True and start parameter was greater than zero. Fixed. 

• When chart pane is being resized/dragged, real-time chart refreshes are temporarily held to prevent 
disappearing of tracking rectangle 
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CHANGES FOR EARLIER VERSIONS ARE DOCUMENTED IN RELEASE NOTES DOCUMENT THAT 
YOU CAN FIND IN AMIBROKER INSTALLATION FOLDER. 


Detailed Change Log 


39 



Tutorial 


This chapter will guide you through the most important parts of AmiBroker. 

Basic tasks: 

• Basic operations 
User interface topics: 

• Beginners' charting guide 

• How to use drag-and-drop charting interface 

• Chart themes 

• User interface customization 

• Working with chart sheets and window layouts 

• Working with layers 

• Using Web Research 

• Using Account Manager 

• Using Fundamental data 

• Using New Analysis window 

Updating quotes: 

• How to get quotes from various exchanges 

• Setting up eSignal RT feed (RT version only) 

• Setting up myTrack RT feed (RT version only) 

• Setting up Quote Tracker as a RT data source 

• Setting up IQFeed RT feed (RT version only) 

• How to use AmiBroker in Real Time mode (RT version only) 

• Using AmiBroker with other external data source (Quotes Plus, TC2000 / TCNet, Metastock, 
FastTrack) 

• Automatic update of EQD quotes for US & Canada markets from Yahoo 

• Using manual mode of AmiQuote downloader (Yahoo, MSN Money Central, Quote.com Livecharts) 

• Using Metastock importer 

Database management: 

• Understanding database concepts 

• Understanding categories 

• Working with watch lists 

AmiBroker Formula Language topics: 

• Understanding how AFL language works 

• Creating your own indicators 

• Using graph styles and colors in the indicators 

• How to create your own exploration 

• How to write your own chart commentary 

• Using studies in your AFL formulas 

• Backtesting your trading ideas 

• Portfolio backtesting 


Tutorial 


40 




AmiBroker 6.00 User's Guide 


Tutorial 


• Reading backtest report 

• How to optimize a trading system (advanced) 

• Waik-Forward testing (advanced) 

• Backtesting futures (advanced) 

• Pyramiding/scaiing and muitipie currencies in the portfoiio backtester (advanced) 

• Monte Cario simuiation of trading systems (advanced) 

• Using formuia-based alerts (advanced) 

• Using interpretation window (advanced) 

• Multiple time frame support (advanced) 

• Efficient use of multithreading (advanced) 

• Ranking functionality (advanced) 

• How to use code snippets 

More information: 

• Video Tutorials On-Line 
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Basic operations 

Adding a new symbol 

In order to add a new symbol into database you can use Symbol->New menu item or Add symboi tooibar 
button. 

After seiecting this function you wiii be prompted for new ticker symboi. The maximum ticker symboi iength is 
48 characters. For proper import functioning you shouid enter the symboi with CAPITALS. 

Removing a symbol 

In order to remove existing symbol from the database you can use Symbol->Remove menu item or Remove 
symbol toolbar button. After choosing this function you will be asked for confirmation of symbol removing. 

Note well that this operation can not be undone Ml 

Removing multiple symbols at once is possible using Assignment organizer. 

Splitting a stock 

To perform stock split use Symbol->Split menu item or Split toolbar button. 

AmiBroker provides easy way of handling stock splits. Program will try to guess split date and ratio by 
analyzing quotations. If there is just a single quotation after split this should work, if not you will be asked for 
split date and ratio. Note well that this operation can not be undone!!! 

From version 2.0 and up the split function offers more functionality: you can use old-style ratio or you can 
specify a split using following expression: 

x->y 

which means that x shares before split become y after it. For example 2->3 means that 2 shares become 3 
after the split. So ordinary split into five pieces will be 1->5. 

As you have probably guessed it is possible now to perform reverse-split, for example 2->1, which means that 
2 shares are joined together into 1 share. 

Deleting quotation 

To delete a quotation simply select the quote you want to delete by clicking on the chart (a vertical line will 
appear showing selected date and quote). Then choose Edit->Delete quotation menu option. 

To delete quotations of all stocks from given day you should use Edit->Delete session. 

You can also use Quote Editor to delete quotes. 

Adding/removing symbol from favourites 

To add the symbol to the favourites you should check favourite box in the Information window. To remove it 
from favourites simply uncheck that box. Alternatively you can click on the tree with the right mouse button 
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and select "Add to favourites" and "Remove from favourites" options from the context menu. 

Merging quotations of two symbois 

It happens sometimes that the ticker for the symbol is changed then you may get two tickers in your database 
- one holding historical quotes and the second one holding newest quotes (after name change). In order to put 
all quotes to the single ticker you should use Symbol->Merge feature. You should just select the new ticker 
(after name change) and choose Symbol->Merge. Then from the combo you should choose original ticker 
("merge with") and optionally check the following fields: 

• overwrite duplicate quotes - checking this option will overwrite the quotes already existing in "new" 
ticker with those present in "old" ticker (this should really not be the case, but may happen). 

• delete "merge with" afterwards - checking this option will delete the "old" ticker after merging 

• assign alias name - checking this option will copy the "old" ticker to the alias field of the "new" ticker 
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Beginners' charting guide 

Introduction 

AmiBroker charting engine aiiows object-oriented manipuiation of aii drawings. Now you can simpiy move, 
resize, cut, copy, paste and delete all drawing objects with ease. This chapter will guide you though most 
important aspects of using charting tools. 

Let's now take a look at the user interface: 



As you can see the in the center we have chart area in which price chart with moving average and Bollinger 
bands is plotted (you can control the apperance of built-in charts from Tools->Preferences window). 

In the bottom of the chart you can see date axis (marked with red color), and below scroll bar and chart sheets 
tab control. Scroll bar can be used to display past quotes, while sheet tab allows to view different chart 
pages/sheets (click here to learn more about chart sheets). 

To the right you can see Y-axis area (marked with blue color) that shows Y-scale and value labels. Value 
labels are color fields that display precisely the "last value" of plots. "Last value" is the value of the indicator 
(or price) for the last currently displayed (rightmost) bar. Y-axis area is used also to move/size chart vertically. 

Next to the right is a drawing objects toolbar that allows you to choose from available drawing types (note that 
only most popular tools are shown here, complete set is available from Insert menu). A special tool called 
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"Select" (red arrow) is used to select/move/resize already drawn objects and to select quotes from the chart. 

In the upper part you can see formatting toolbar that allows you to quickly modify color, style (thick/dotted) and 
mode (snap to price) of currently selected drawing object. 

In the picture you can also see the trend line drawn with sizing handles marked. These handles are used to 
drag/size the object as will be explained below. 

Basic operations 

Scrolling 

To scroii the chart forward/backward just drag scroll bar thumb or use < and > arrows on the left and right 
sides of the scroll bar. Note that using < > scroll bar arrows allows you to move chart by one bar. To scroll the 
chart you can also use the mouse equipped with a wheel. Just roll the wheel up and down to scroll back and 
forward. 

Zooming 

To zoom the chart (increase or decrease number of data points (bars) displayed) you can use either 
View->Zoom menu, zoom toolbar or mouse wheel. 

You can also zoom by dragging the ieft or right edge of scroii bar. There are following options available: 
zoom-in - decreases the number of data points displayed, zoom-out - increases the number of data points 
displayed, zoom-all - displays all available bars, zoom-normal resets number of bars displayed to the value 
defined in Toois->Preferences->Charting. Zoom-in and zoom-out options are accessible directly from the 
View toolbar, (see picture below). To zoom using mouse wheel just press and hold down CTRL key and roll 
the wheel. You can also zoom to any from-to range selected on the chart (see 'Marking range' later in this 
tutorial) 

Shrinking, expanding and moving Y-axis scale 

To move Y-axis scale hover the mouse to Y-axis area (marked with blue color in the picture above) and you 
will see that cursor changes to up/down arrow. Now you click and drag up/down Y axis and release button 
when the axis is in the correct position. 

To shrink/expand Y-axis scale: press down SHIFT key and click in the Y-axis area, now shrink/expand Y axis 
scale by moving your mouse up and down. Release the button to finish. 

To reset Y-axis scale and position simply double click in the Y-axis area. 

Changing bar interval (periodicity) 

You can easily switch between daily/weekly/monthly and intraday intervals by choosing it from View menu 
and pressing the toolbar button (see below). 
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I 


b 

d 

w 

m 

if 

m 

e 


Zbom-in 

Zoom-out 


Bar 

Interval 


Close 

pane 

Arrange 

Profile 


The toolbar uses following notation for intervals - i -intraday, h - hourly, d - daily, w - weekly, 
m - monthly. The i represents "base" intraday interval as defined in File->Database Settings. 
Remaining intraday intervals are available from View->lntraday menu. 

The interval setting affects active window only, so each window can have different interval. 

Please note that intraday intervals are disabled if your database is in end-of-day mode. 
Intraday modes are available only for databases that have "Base time interval" in 
File->Database Settings set to anything less than end-of-day. If you for example set "Base 
time interval" in File->Database Settings to 5-minute, all chart periodicities from 5-minutes up 
will be enabled. 


The following intervals are built-in: 


• daily 

• weekly 

• monthly 

• hourly (intraday) 

• 15-minute (intraday) 

• 5-minute (intraday) 

• 1-minute (intraday) 

• 15-second (intraday RT only) 

• 5-second (intraday RT only) 

• tick (intraday RT only) 


In addition to that you can define 5 custom n-minute bar intervals and 5 custom n-tick intervals in 
Tools->Preferences->lntraday. Custom intervals are available from View->lntraday menu only. 


Selecting a quote 


You can very easily see the past quote and values of indicators by using "select" mode. To select past quote 
first switch to "Select" mode (red arrow in the toolbar) then click in the chart area (but not on the drawing 
object). A vertical line will show up marking the quote under the cursor. The chart title will display this bar 
quote. Indicator panes will show indicator value for given bar. Once quote is selected you can move to 
previous/next quote using keyboard left and right arrow (cursor) <- and -> keys. 


To switch off quote selection either click again on the line or click in the date axis area (marked with red color 
in the picture above) or click in the right margin (blank quotes) area. When selection is off chart title displays 
the values for last visible bar. 


Marking range 

To show range marker just double click the chart at the beginning of the range and double click again at the 
end of the range. You can also use FI2 key in conjunction with "select" mode (described above). Just select 
quote and press FI2 for begin and SHIFT+F12 for the range end. You can switch off the range marker by 
pressing CTRL-I-F12 key or double clicking in the same place twice. 

Range markers can be used to select zoom-in range (View->Zoom->Range) and to perform calculations on 
selected values via BeginValue and EndValue AFL functions. 

Adding / closing chart panes 
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Each window can consist of severai panes dispiaying various charts / indicators. To display a new indicator in a 
separate chart pane just find the indicator in the Charts list (use Window -> Charts menu) and double-click on the indicator name. 
For more information see Drag&drop charting tutorial. 

To close any chart pane: click on the pane, then use either View->Pane->Close from main menu or click on 
the pane with right mouse button and choose Close from context menu. 

Linking and locking chart 

Multiple chart windows (that were open usign File->New->Default Chart or File->New->Blank chart) can be 
interval-linked, symbol-linked using appropriate small "S" and "I" buttons that appear on the left side of the 
scroll bar. When you click on button the menu showing colors will pop up, select one color from 2 or more 
charts and symbols linked using same color will be linked using symbol and/or interval. Linking means that 
change of the symbol and/or interval in one of the linked windows automatically changes symbol and/or 
interval in all linked windows using same link color. 

You can also prevent symbol from being changed for given chart. It can be done by turning on little pad lock 
button ("Symbol Lock") on the right side of the scroll bar. When chart is symbol-locked, it will not allow to 
change the symbol selected unless the lock is released (by pressing pad lock button again). 

Using drawing tools 

AmiBroker features extensive set of drawing tools: 


y Select 
y Trendline 
/ Ray 
Extended 
J Vertical 
" Horizontal 
// Parallel 
Recession 
# Channel 

O Rectangle 
O Ellipse 
abc Text 
A. Triangle 
Pitchfork 
Arc 

|..H Cycles 

Flbcnacd 

Retracement 

Time zones 


The following tools are available: 



Fib.Fan 


Fib. arc 

ffl 

Gann square 


Gann fan 

= 

Fibcnacd 

extension 

Hi 

Time 

extension 


trend line 

ray (new in 4.20) 

extended line (new in 4.20) 

vertical line 

horizontal line 

parallel lines (new in 4.20) 

Regression channels: Raff, standard deviation, standard error (all new in 4.20) 
Fibonacci Retracement study (enhanced in 4.20) 

Fibonacci Time zones study 
Fibonacci Fan 
Fibonacci arc 

Gann Square (new in 4.20) 

Gann Fan (new in 4.20) 

Ellipse tool 
Arc tool 
Rectangle 
text box tool 


They are available from Insert menu and Draw toolbar. Each drawing object can be moved, 
resized, copied, deleted and modified after it is drawn. 
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To draw an object on the chart switch on appropriate tooi button (see picture beiow) and start drawing on the 
chart by pointing the mouse and pressing ieft mouse button where you want to start the drawing. Then move 
the mouse. Study tracking iine wiii appear. Reiease ieft mouse button when you want to finish drawing. You 
can aiso cancei study drawing by pressing ESC (escape) key. 

If you hover your mouse over the object you wiii see that cursor shape changes in the proximity of the object. 
This means that 


If cursor is near either end of the object it will change its shape to sizing pointer: 

\ 

If the cursor is near remaining parts of the object it will change its shape to moving pointer: 

❖ 

Once object is drawn it can be selected, moved, resized, deleted, copied. 


Selected object 

(sizing handles are shown) Click and drag here to 

size.^^ 


Click and drag here to 

move 

\ 




:lick and drag here to 
size 


To select the object simply move the mouse over the object 
so "moving pointer" appears and click once - the object will 
be marked so the sizing handles (see first picture) will 
appear. 

To de-select click in the blank chart space. 

To size the object click on the sizing handle and drag to the 
desired location as shown in the picture. 

To move the object click on any other part of the object and 
move to the desired location. 


To delete object - select it first and press DEL (DELETE) key on the keyboard or use Edit->Delete menu or 
use Delete toolbar button. 


To copy the object to the clipboard - select it first and press Ctrl+C or use Edit->Copy menu or use Copy 
toolbar button. 

To cut the object - select it first and press Ctrl+X or use Edit->Cut menu or use Cut toolbar button. 

To paste the object from the clipboard press Ctrl+V or use Edit->Paste or use Paste toolbar button. Pasted 
object will drawn in the exactly same location as copied one and will be selected automatically so you can 
move it to a new location. 

To apply color or style to the object select it and use Format menu or Format tool bar buttons to change 
color, thick, dotted and snap to price styles. Note that you can also select color and style of the object before 
drawing new object: simply deselect previous object (if any), change color / style selections and draw new 
object. 

To modify properties of the object - either double click it or use Edlt->Propertles menu or Alt+ENTER key 

To delete all objects use Edlt->Delete All menu 
Further Information 
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To learn more about drawing tools please read Drawing tools reference chapter. 
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How to use drag-and-drop charting interface 

Introduction 

AmiBroker allows you to easily create and modify your indicators with few moves of a mouse. From now on you can build 
sophisticated indicators without any programming knowledge at all. The available (ready-to-use) indicators are listed in Charts tab 
of the Workspace window. 

There is a video tutorial at: http://www.amibroker.net/video/dragdrop1 .html that shows basic usage of new 
drag and drop functionality. 

How to insert a new Indicator. 

To display a new indicator in a separate chart pane just find the indicator in the Charts list (use Window -> Charts menu) and 
double-click on the indicator name. 


Charts 


If X' 


$-L 

$L 

J Bands ■» 

f Bollinger Bands 
f Keltner Bands 
f Percent Bands 
] Basic Charts 

f Open Interest (futures) 

f J _ LJ 


f Pric 

Insert 


/ Pric 

Insert Linked 


f Relj 



/ Voli 

Overlay 


f Voli 

Analysis 


f Voli 



/ Voli 

Edit 

f Bolling( 

Rename 

I'l Custorr 

Delete 


f My 



f Unr 

New ► 


/ Unr 



f Unr 

Refresh 


Alternatively you can choose Insert from the context menu. As a result new indicator pane will be created and Parameters dialog 
will be displayed. Here you can change the properties of the indicator (like color or periods). To accept the settings press OK button, 
(you will find the detailed description of parameters window below). 

Example: 

To insert RSI pane - find RSI indicator in the list, double-click on the name, select the number of periods and color, then press OK. 


How to overlay one Indicator on another Indicator. 

To overlay one indicator on another one, press LEFT mouse button on the indicator name, drag (with mouse button held) the 
chosen indicator into the destination pane and release the button. 

Example: 

To insert another RSI (based different periods number) into the same pane - drag RSI into the previously created RSI pane, change 
the number of periods in the Parameters window and press OK 
Alternatively you can choose Overlay option from context menu. 
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How to delete the indicator. 

To remove the indicator, press Close button from the menu on the top right-hand side of the indicator pane (the menu will be 
displayed if you place the mouse cursor in the nearby). This menu allows you also to move the indicator pane up/down or maximize 
the pane. 



You can also use Close command from context menu that shows up when you click on the chart pane with 
right mouse button. 


Parameters... 

G 

Edit formula... 

Intraday ► 

w Weekly view 
m Monthly view 
Pane 
Template 
Symbol Link 
Interval Link 
Delete indicator 

Lock symbol 
X Close 


d Daily view 


How to remove the Indicator plot from the pane. 


To remove one of the indicators displayed in the indicator pane - click with RIGHT mouse button on the chart title (near the top of 
chart pane) and select the indicator that you want to remove. 


Q - ^ Rtirrist = s? ififli 

Delete TSF 
Delete RSI 

r 




You can also remove the indicator plot using Delete Indicator option from chart context menu. 
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How to change parameters/colors/styles of indicators. 

The Parameters window allows you to change parameters, colors and styles of your indicators. Parameters window is displayed 
when you insert a new indicator. You can also click RIGHT mouse on the chart pane and choose Parameters from the context 
menu. Parameters window displays all the parameters defined in AFL code of certain indicators (also user-defined parameters) so 
it's contents depends on the indicator chosen. However - for most of the indicators you will see: 

• Price Field - the data used to calculate the indicator. If the 'Price Field' contains 'Close', it means that indicator is 
calculated out of Close prices. Price Field is not available for all indicators, because not all indicators allow you to choose 
the input (e.g. ADLine). 

• Periods - defines the number of periods used to calculate the indicator 

• Color - allows you to change the color of the indicator 

• Style - allows you to determine the style of the plot (the styles are described in more detail in Using graph styles and 
colors tutorial section. 


How to overlay indicators with different scales. 

To have in one pane two (or more) indicators that use different scaling, drag the second indicator onto the first one, in Parameters 
window click on Style field and check StyleOwnScale setting. 

Example: 

Drag OBV (On Balance Volume) into RSI pane. Then define style as styleOwnScale. As a result - both indicators are visible and 
properly displayed. 


How to create an indicator based on another indicator. 

AmiBroker allows you also to easily create indicators based on values of another indicator. All you need to do is to press LEFT 
mouse button on the indicator name, drag (with mouse button held) the chosen indicator into the destination pane and release the 
button. As a result - the indicator will be placed in the existing chart pane. In the parameters dialog Price field parameters indicates 
what base values are used to calculate the indicator. 

Example: 

To calculate Simple Moving Average of previously created RSI indicator, drag the MA indicator into RSI pane. The contents of 
"Price Field" parameter indicates, that Moving Average is calculated out of RSI(15) values. (See the below picture). 
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NOTE: The part below contains technical information for advanced users only. Beginners may skip this part. 

Using Param(), ParamColor(), ParamToggleQ, ParamStyleQ functions 

These functions, when used in formula, allow you to change indicators' settings directly from Parameters window. 


Param( ("name", defvalue, min = 0, max = 100, step = 1, sincr = 0 ) 

Adds a new user-definable parameter, whioh will be accessible via Parameters dialog. 

• "name" - defines parameter name that will be displayed in the parameters dialog 

• defvalue - defines default value of the parameter 

• min, max - define minimum and maximum values of the parameter 

• step - defines minimum increase of the parameter via slider in the Parameters dialog 

• sincr - defines the increase of default value when more than one section of the same kind is inserted (dropped) onto the 
chart. For example if you insert the default Moving Average indioator into the same pane twice, the first moving average 
will be based on 15 periods, the other one on 25 {defvalue=15 + sincr=10) 


ParamColor( "name", defaultcolor) 

Adds a new user-definable color parameter, aocessible via Parameters dialog. 

• "name" - defines parameter name that will be displayed in the parameters dialog 

• defaultcolor - defines default color value of the parameter 

ParamColor function allows you to use colorCycle as a default value. When you use colorCycle parameter, default color cycles 
through red, blue, green, turquoise, gold, violet, bright green, dark yellow, when you insert your indicators into the same pane. 


ParamStyle( "name", defauitval = styleLine, mask = maskDefault ) - allows to select the styles applied to the plot from the 
Parameters window. Apart from styles available in previous versions of AmiBroker, there are two new style constants: 

• styleHidden - a combination of styleNoDraw | styleNoRescale 

• styleDashed - dashed line 

The list of available styles displayed in the Parameters window depends on the mask parameter. 

• maskDefault - show thick, dashed, hidden, own soale styles (this is default mask for ParamStyle) 

• maskAII - show all style flags 

• maskPrice - show thick, hidden, own scale, candle, bar 

• maskHistogram - show histogram, thick, hidden, own scale, area 


ParamField("name”, field = 3) - allows to pick the Price field for the indicator (field which is used to calculate values of the 
indicator). Function returns the array defined by field parameter. Default value = 3 returns Close array. The possible values of field 
parameter are: 

• -1 - ParamField returns the values of the indicator that was inserted as a first one into the pane, or Close if no indicator 
was present 

• 0 - returns Open array 

• 1 - returns High array 

• 2 - returns Low array 

• 3 - returns Close array (default) 

• 4 - returns Average array = (H-hL-hC)/3 

• 5 - returns Volume array 

• 6 - returns Open Interest array 

• 7,8,9. - return values of indioators inserted into the pane. 


ParamJogg\e{"name","values",defaultval=0) - function that allows to use boolean (Yes/No) parameters. 
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• "name" - the name of the parameter 

• "values" - parameter values (separated with | character, e.g. "No|Yes" - first string represents false value and second 
string represents true value) 

• defauitval - default value of the parameter 


Example: 

The below Indicator allows you to check how the parameters work In the custom code. You can change settings from Parameters 
dialog. 

Buy = Cross (MACD 0, Signal () ); 

Sell = Cross (Signal 0, MACD () ); 

pricefield = ParamField ( "Price Field", 2); 

Color = ParamColor ( "color" , colorRed); 

style = ParamStyle ("style ", styleLine, maskAll); 

arrows = ParamToggle ( "Display arrows", "NolYes",0); 

Plot (pricefield, "My Indicator", Color,style); 
if (arrows) 

{ 

PlotShapes (Buy*shapeUpArrow+Sell*shapeDownArrow, Ilf (Buy,colorGreen,colorRed) ); 

} 


Special functions: SECTION_BEGIN, _SECTION_END, _SECTION_NAME, _DEFAULT_NAME, _PARAM_VALUES explained 
(for advanced users only) 

These are new functions that are used by drag & drop mechanism. The most important pair is 
_SECTION_BEGIN("name") and _SECTION_END(). 

When you drop the formuia onto chart pane AmiBroker appends the formuia you have dragged at the end of 
existing chart formuia and wraps inserted code with _SECTION_BEGIN("name") and _SECTION_END() 
markers: 

So, if original formula looks as follows: 

P = ParamField ( "Price field", -1); 

Periods = Param ( "Periods" , 15, 2, 200, 1, 10 ) ; 

Plot ( MA ( P, Periods ), _DEFAULT_NAME(), ParamColor ( "Color", colorCycle ), 
ParamStyle ( "Style" ) ) ; 

it will be transformed by AmiBroker to: 

_SECTION_BEGIN( "MA" ) ; 

P = ParamField ( "Price field", -1); 

Periods = Param ( "Periods" , 15, 2, 200, 1, 10 ) ; 

Plot ( MA ( P, Periods ), _DEFAULT_NAME(), ParamColor ( "Color", colorCycle ), 
ParamStyle ( "Style" ) ) ; 

_SECTION_END() ; 

_SECTION_BEGIN/_SECTION_END markers allow AmiBroker to identify code parts and modify them later 
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(for example remove individual sections). In addition to that sections provide the way to make sure that 
parameters having the same name in many code parts do not interfere each other. For example if you drop 
two moving averages the resulting code will look as follows: 

_SECTION_BEGIN( "MA" ); 

P = ParamField ( "Price field", -1); 

Periods = Param ( "Periods" , 15, 2, 200, 1, 10 ) ; 

Plot ( MA ( P, Periods ), _DEFAULT_NAME(), ParamColor ( "Color", colorCycle ), 
ParamStyle ( "Style" ) ) ; 

_SECTION_END(); 

_SECTION_BEGIN ("MAI") ; 

P = ParamField ( "Price field", -1); 

Periods = Param ( "Periods" , 15, 2, 200, 1, 10 ) ; 

Plot( MA( P, Periods ), _DEFAULT_NAME(), ParamColor ( "Color", colorCycle ), 
ParamStyle ( "Style" ) ) ; 

_SECTION_END(); 

Note that code and is parameter names are identical in both parts. Without sections the parameters with the 
same name will interfere. But thanks to uniquely named sections there is no conflict. This is so because 
AmiBroker identifies the parameter using section name AND parameter name, so if section names are unique 
then parameters can be uniquely identified. When dropping indicator AmiBroker automatically checks for 
already existing section names and auto-numbers similarly named sections to avoid conflicts. Section name 
also appears in the Parameter dialog: 


Properties of: Unnamed 7 



Last but not least: you should NOT remove _SECTION_BEGIN /_SECTION_END markers from the formula. 
If you do, AmiBroker will not be able to recognize sections inside given formula any more and parameters with 
the same name will interfere with each other. 

_SECTION_NAME is a function that just gives the name of the function (given in previous _SECTION_BEGIN 
call). 

_DEFAULT_NAME is a function that returns the default name of plot. The default name consists of section 
name and comma separated list of values of numeric parameters defined in given section. For example in this 
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code: 

_SECTION_BEGIN( "MAI" ); 

P = ParamField ( "Price field"); 

Periods = Param ( "Periods" , 15, 2, 200, 1, 10 ) ; 

Plot ( MA ( P, Periods ), _DEFAULT_NAME(), ParamColor ( "Color", colorCycle ), 
ParamStyle ( "Style" ) ) ; 

_SECTION_END(); 

_DEFAULT_NAME will evaluate to "MA1 (Close,15)" string. 

_PARAM_VALUES works the same as _DEFAULT_NAME except that no section name is included (so only 
the list of parameter values is returned). So in above example _PARAM_VALUES will evaluate to "(Close, 
15)" string. 


Frequently Asked Questions about drag & drop functionality 

Q. What is the difference between insert and insert Linked option in chart menu? 

A. Insert command internally creates a copy of the original formula file and places such copy into hidden 
drag-drop folder so original formula will not be affected by subsequent editing or overlaying other indicators 
onto it. Double clicking on formula name in the chart tree is equivalent with choosing Insert command from 
the menu. On the other hand Insert Linked command does not create any copy of the formula. Instead it 
creates new chart pane that directly links to original formula. This way subsequent editing and/or overlaying 
other indicators will modify the original 

Q. / can not see buy/seii arrows from my trading system 

A. Trade arrows can be displayed on any chart pane (not only one built-in price chart). However, by default, 
the arrow display is turned OFF. To turn it ON you have to open Parameter dialog, switch to "Axes and grid" 
and switch "Show trading arrows" option to "Yes". 
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Q. The read me says: "Automatic Anaiysis formuia window is now drag&drop target too (you can drag 
formuias and AFL fiies onto it)". What does it mean? 
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A. It means that you can drag the formula from either Chart tree or .AFL file from Windows Explorer and drop 
it onto Automatic Analysis (AA) formula window and it will load the formula into AA window. This is an 
alternative to loading formula via "Load" button in AA window. 

Q. Can I drop a shortcut onto the formula window ? 

A: No you can't. You can only drag & drop files with .AFL extension (shortcuts in Windows have .Ink 
extension). 

Q. Can I add my own formulas to the Chart tree ? 

A. Yes you can. Simply save your .AFL formula into Formulas subfolder of AmiBroker directory and it will 
appear under "Charts" tree (View->Refresh All may be needed to re-read the directory if you are using 
external editor) 

Q. / have added new file to the Formulas folder, but it does not show up in the Charts tree unless I 
restart AmiBroker? Is there a way to refresh Chart tree ? 

A. You can refresh Chart tree by choosing View->Refresh All menu. 

Q. If I modify the formula that ships with AmiBroker will it be overwritten by next upgrade? 

A. Yes it will be overwritten. If you wish to make any modifications to the formulas provided with AmiBroker 
please save your modified versions under new name or (better) in your own custom subfolder. 

Q. / can see Reset All button in Parameters dialog but it sets all parameters to default values. Is there 
a way to reset SINGLE parameter ? 

A. No, there is no such option yet, but it will be added in upcoming betas. 

Q. / dragged RSI to the price chart pane and got a straight red line at the bottom of the pane. What is 
wrong? 

A. When you drop two indicators / plots that have drastically different values you have to use style OwnScale 
for one of it. You can turn on OwnScale style using Parameter dialog. This ensures that scales used for each 
are independent and you can see them properly. Otherwise they use one common scale that fits both value 
ranges that results in flattened plots. 

Q. The light grey color of the new AFL special functions_SECTION_BEGIN etc makes them invisible in 
my bluegrey background IB color. How could I change the special functions color ? 

A. Right now, you can't. But there will be a setting for coloring special functions in the next version. 

Q. When I drop the indicator the Parameter diaiog does not show aii parameters, is this correct ? 

A. Yes it works that way. The idea behind it is simple. When you drop new indicator AmiBroker displays a 
dialog with parameters ONLY for currently dropped indicator. This is to make sure that newly inserted 
indicator parameters are clearly visible (on top) and new user is not overwhelmed by tens of other parameters 
referring to previously dropped indicators. On the other hand when you choose "Parameters" item from 
context menu then ALL parameters will show up - allowing you to modify them all any time later. 


Special functions: SECTION_BEGIN, _SECTION_END, _SECTION_NAME, _DEFAULT_NAME, 5PARAM_ 



AmiBroker 6.00 User's Guide 


Tutorial 


Chart themes 


58 



AmiBroker 6.00 User's Guide 


Tutorial 


Chart themes 

AmiBroker 5.52 introduces 6 pre-defined chart themes switchabie in Toois->Preferences, "Axes & Grid" tab: 
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1. Basic Theme 
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2. Nature Simple Theme 
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3. Nature Gradient Theme 
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4. Gray Theme 
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5. Dark Gray Theme 
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6. Black Theme 
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User interface customization 


A newly introduced customizable user-interface has several nice features that allow complete control over 
look and feel of AmiBroker user interface. 

Advanced nested docking / tear-off tabs 



To dock a pane into any side of the application or as a tab simply click on docking window caption bar and 
drag it. If you do this, docking stickers will show up to make it easy to choose destination place as shown 
below 
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You can also click on docking pane tab and drag it (tear off) and dock as a separate window. This way you 
can arrange all docking windows either as separate windows or as tabs or as a mixture of these two 
approaches. You can also make window / tab floating if you drag it while holding down CTRL key. 


Sliding Auto-hide panes 

Another very useful feature that allows to conserve precious real estate on your monitor is auto-hiding of 
panes. To control (switch on/off) this feature there is a pinup button in the upper right corner of each docking 
window. If you unpin it - the pane will automatically hide when it loses focus. 
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Advanced customizable toolbars, menus and keyboard shortcuts 

New user interface allows full user control over appearance, layout and position of all toolbars, buttons and 
menus. It allows you to add your own buttons, remove/re-arrange existing ones. Also you define or re-define 
new/existing keyboard shortcuts. All these customization features are available from Tools->Customize 
menu or from Customize chevron menu. 



Chevron menu is available from little arrow button placed at the end of toolbar strip. It allows to access 
auto-hidden elements of the toolbar as well as customization features. 
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Add or Remove buttons submenu allows to quickly show / hide toolbar buttons according to your preference. 
In customization mode (when you enter it using Tools->Customize you can also move buttons around to 
change the order in which they appear, and you can also resize edit fields and combo fields (such as ticker 
selection field) by selecting them first and resizing the border that will show after making selection. 
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You can even add and design your own buttons using buiit-in image editor: 
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Uame: My Button 

Copy Button Image 
Paste Button Image 
Reset Button Image 
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RMB click in customize 
mode allows even 
drawing your own button 
images 




Themed appearance 

AmiBroker aliows aiso to pick your preferred user-interface "appearance" or "theme" to suit your personal 
taste. 
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MDI (multiple document interface) tabs 



AmiBroker is multipie document interface (MDI) application. In short it means that it allows you to open and 
work with multiple windows at the same time. To learn more about what MDI is you may check this article: 
http://en.wikipedia.org/wiki/Multiple_document_interface 

Now MDI tabs (shown in the picture above ) are just an additional way to switch multiple open windows (in 
addition to Window menu where the list of open document windows is also available). 

It is important to understand that MDI tabs are not "user definable" in the sense that you can not define their 
names freely, unlike chart sheets (which are definable). Their names are automatically derived from 
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document/window name. For chart windows the name is aiways in the format of: Symboi - FuiiName, web 
browser windows use FITML page titie (as defined by FITML document), account manager windows use actuai 
account fiie name (that you can choose when you save them). 

MDI tabs are basicaiiy document window switcher (iike Windows TASK BAR in the bottom) and they are 
automatically managed by AmiBroker whenever you open new or close window. 

And it works exactly using the same idea as Windows task bar. Let us look at this analogy closer: 

When you use Windows Task Bar: 

- you open the application - a new button in the task bar appears 

- and you can switch between open applications using task bar buttons. 

- you can not rename the button because it represents application name. 

- and you need to be careful with opening too many applications because all open applications consume 
system resources 

Now using AmiBroker MDI tabs: 

- you open the document (window) -> a new button (tab) appears 

- you can switch between open windows using buttons (tabs) 

- you can not rename the button because it represents document/window name 

- and you need to be careful with opening too many documents/windows because all open documents 
consume system resources 

You can turn off MDI tabs by unchecking "Show MDI tabs" box in the Tools->Customize, Appearance page, 
as shown below: 



Historical note: In pre-4.90 versions, to switch the documents you would need to use Window menu. Now in 
addition to that you can use tabs. But this is just convenience feature, more info at: 
http://en.wikipedia.org/wiki/Tabbed_Document_lnterface (Note that Wikipedia links describing TDI / MDI are 
somewhat outdated and AmiBroker actually combines advantages of BOTH TDI and MDI approaches (for 
example you can tile windows in AB's TDI) 
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For more information see Flouston conference presentation: http://www.amibroker.com/docs/Flouston1.pdf 
(PDF format), http://www.amibroker.com/docs/Flouston1.htmi (Fiash format). 
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Working with chart sheets and window layouts 

AmiBroker manages multiple chart sheets and multi-window layouts with ability to quickly load/save thems. 
This feature enables you to quickly switch between different indicator sets saving your time dramatically. 

Chart sheets and templates 

A chart sheet is a set of chart panes (with indicators) displayed within single frame. 

You can switch between different sheets by clicking on the tabs located in the bottom of AmiBroker window as 
show in the following picture: 



(; 2005-10-14, Bar; 1455 Y; 51.9103 Forex, Group 254, Services, Advertising 

You can change the name of the tab by clicking on it with RIGHT mouse button, so the following window 
appears: 



You can change all four tab names (one by one) so they are more descriptive (and they relate to the contents 
of the sheet). 

You can scroll tabs using arrow buttons and you can re-arrange them by dragging (click on tab, hold down left 
mouse button and drag to desired position - an arrow will show target position). 



You can also access any sheet quickly by clicking with RIGHT mouse button over arrows to pop-up the menu 
that lists all tabs and allows immediate selection (without scrolling) 
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The next step is to set up your sheets according to your personal preference. Just add/remove chart panes 
to/from each sheet. This way you can have upto 60 different indicator sets that you can recall very quickly by 
switching to appropriate tab. The actual number of sheets is definable in Tools->Preferences->Charting 
"Number of chart sheets" 

The complete set of chart sheets is called a "template" and you can make this setup permantent just 
right-click on the chart and select the following menu item (Template->Save, Template->Save as default): 

The default template is used if you create a new window (Window->New) 

You can also load once saved template by choosing Template->Load from chart's right mouse button menu. 

In addition to old local template format a new one is added with .chart extension that keeps not only window 
sizes and formula references (paths) but also formulas themselves, so all you need to do is to save your chart 
into one file (Chart Template, Complete *.chart) and copy that file onto different computer and chart will be 
recreated with all formulas linked to it. 

To Save chart into new format do the following: 
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1. Click with RIGHT MOUSE button over the chart and select Template->Save... 
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2. In the file dialog, "Files of type" combo select "Chart Template, Complete (*.chart)" 

3. Type the file name and click Save. 

To load previously saved complete chart do the following: 

1. Click with RIGHT MOUSE button over the chart and select Template->Load... 

2. In the file dialog, select previously saved *.chart file and press "Open" 

Note: The procedure AmiBroker does internally is as follows: When you save the chart into new format it 
saves XML file with: 

a) names of all sheets, panes, their sizes, locations and other settings 

b) paths to all formulas used by all panes 

c) the text of formulas themselves 

When you load the chart in new format AmiBroker: 

a) sets up the sheets/panes according to information stored in the file 

b) for each formula stored in the file it checks if the same formula exists already on target computer: 

- if it does not exist - it will create one 

- if it exists and the contents is identical to the formula stored in .chart file it will do nothing 

- if it exists and the contents is different then it will create NEW formula file with Jmported.afI suffix (so old file 
is not touched) and will reference the pane to the Jmported.afI formula instead. 

IMPORTANT NOTE: if you use any #include files AmiBroker will store the contents of include files as well 
inside chart file and will attempt to recreate them on target machine. Please note that in case of includes it will 
check if it exists and if it is different. If both conditions are met (different file exists already) it will ask to replace 
or not. If you choose to replace - it will replace and make backup of existing one with .bak extension. If you 
are using any files in "standard include files" and include them using <> braces, AmiBroker will restore files in 
target machine standard include folder as well (even if the standard include folder path is different on the 
source machine). 

A new .chart format is intended to be used to port charts between different computers. For storing 
layouts/templates on local computer you should rather use old formats as they consume much less space 
(they store only references,not the formulas themselves). One may however use new format for archiving 
purposes as it keeps formulas and all references in one file that is very convenient for backups. 

Symbol and Interval Linking 

Now it is possible to link chart windows either by symbol and/or by time interval. To link chart windows use 
linking buttons located in the bottom of the chart window as shown in the picture below: 
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Grey "S" and "I" buttons mean no link. Any other color (red, green, magenta, yellow, pink, white, brown, dark 
green, blue) means that given chart belong to given color-coded linked group. All windows with same color 
link will switch symbol and/or interval simultaneously. 

Floating windows 

If you are using multiple monitors, you can find it useful to display AmiBroker charts on multiple windows. To 
make it easy, AmiBroker 5.10 introduces "floating" chart windows. Normally all chart windows live inside main 
AmiBroker application window. If you make chart window floating, you are essentially detaching the chart 
window from parent AmiBroker frame, so you can move it outside, for example to the other monitor. 

You can switch between normal and floating state using Window menu as shown below: 
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The following video tutorial shows how to use floating windows and symbol linking in practice: 
http://www.amibroker.com/video/FloatAndLink.html 

Window layouts 

A window layout is a complete set of multiple windows open each with different symbol, different display 
interval, different size, different set of chart sheets. 

The picture below shows 4-window layout each with different set of indicator panes. To the left you can see 
"Layouts" pane in the Workspace window showing the list of stored local and global layouts. 



Using AmiBroker 4.20 you can now have unlimited number of custom, multiple-window templates that can be 
switched between with just double click on layout name in the "Layouts" tab of the Workspace window. 

You can open, save, delete layout by clicking on the Layout tree with right mouse button and choosing 
appropriate function. "Save As" option saves current layout under new name. 

Local layouts are per-database while Global layouts are visible from all databases. 

Information saved in layouts include: window sizes and postions, maximized/minimized state chart panes 
available on each sheet (independent for each window), selected bar interval, selected symbol, selected chart 
sheet 
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Most recently used layout can be saved on exit and database switch automatically (see: 

Tools->Preferences->Miscellaneous "Save on exit: Layouts") 

Note: since version 4.90 multiple windows can be switched not only using old-style Window menu but also 
using new MDI tabs. More on MDI tabs can be found In the "User-Interface customization" chapter. 
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Using layers 

What layers are 

Layers are like pieces of transparent plastic. You can put drawings on them. Layers can be made visible or invisible. This allows to 
show/hide drawings placed on given layer without affecting the drawings placed on other layers. 

How to work with layers. 

First of all make sure that Workspace window is visible (Window->Layers) 

Then switch to "Layers" tab. Here you can see the list of pre-defined layers. 

The checkboxes on the left side of each layer control layer visibility. If checkbox is marked than given layer is visible, if it is 
unmarked - the layer is invisible. Initially first five layers will be "locked" to intervals. 

These built-in layers are: 

Default layer - always visible 

Intraday layer - visible only when viewing intraday charts 
Daily layer - visible only when viewing daily charts 
Weekly layer - visible only when viewing weekly charts 
Monthly layer - visible only when viewing monthly charts 

A locked layer changes its visibility automatically when interval changes and you can not change its visibility by clicking on the 
left-side checkbox. 

The remaining layers are not locked and they can be shown/hidden freely by marking the checkbox. 

To draw a study in a given layer simply 

a) SELECT the layer first (click on name to highlight it) 

b) DRAW the study as usual 

As long you select the other layer all drawings will be placed on selected layer. After drawing a study you can assign it to any other 
layer via object properties box. 

Context menu 

If you click on layer name with right mouse button you will see the context menu containing the following options: 

Add layer 
Remove layer 
Show all layers 
Hide all layers 
Toggle 

Unlock built-in layers 
Lock built-in layers 
Properties. 

Add/Remove layer are self-explanatory. Please note that you can not remove first 5 (built-in) layers 

Show all/Hide all - shows and hides all NOT LOCKED layers 
Toggle - toggles visibility of all NOT LOCKED layers 

Unlock/Lock built-in layers - allows you to unlock/lock 5 first (built-in) layers. Once layer is unlocked its visibility does not change 
automatically when interval changes and you can show/hide it manually. 
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Properties - this launches properties box that allows you to rename layer and decide if given layer should or should not be locked to 
interval displayed. 

If you mark "Lock visibility to interval" box the layer will show/hide automatically depending on what interval is 
currently displayed. You can define visibility for each layer using "Interval" combo and "Show/hide automatically" buttons. Note that 
there is a ‘separate* visibility setting for EACH interval. The layer properties box ALWAYS shows "monthly" interval at start but this 
is just a startup cendition yeu just switch te particular interval 

and modify visibility. To setup locked layer completely you have to set visibility for every layer listed in the "Interval" combo-box. 
Simply select the interval and choose if layer should be shown or hidden for this interval, select next interval and again choose show 
or hide, select next and se on...until you define visibility for all intervals. 
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Using Web Research window 

Web Research window allows you to view on-line news, research, profiles, statistics and all kind of 
information related to currently selected symbol available over the Internet (World Wide Web). Using Web 
Research instead of plain web browser has speed advantage as you don't need to type complicated/long 
addresses (URLs) each time you need to get desired information. 

Web Research window introduced in version 4.90, replaces and enhances previously available Profile 
window. Now it allows unlimited number of user-definable web research (profile) pages, browsing to any web 
page (just type URL), tab-browsing, opening multiple pages at once, selective auto-synchronization. 

Web-Reasarch uses Internet Explorer engine so you can be sure that pages are rendered with the same 
quality you would get from stand-alone browser. 

OPEN NEW WEB RESEARCH WINDOW 


Use File->New->Web Research menu to create new web research window 
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PICKING PRE-DEFINED WEB RESEARCH PAGE: 


To display any pre-defined web research page, simply click on the drop down arrow in the Address 
combo-box and pick one item from the list. Once you do so, the web page relevant to currently selected 
symbol will be automatically displayed. 
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The Sync button allows to decide when page should be automatically synchronized with currently selected 
symbol. 

• Don't sync - means that page should not be synchronized with currently selected symbol at all 

• Sync active - means that page should be synchronized ONLY when it is currently active or becomes 
active (by user clicking on given tab) - this is recommended setting for web-research profiles since it 
conserves bandwidth and resources (not active pages are not synchronized and do not consume any 
bandwidth) 

• Sync always - means that page is synchronized with currently selected symbol always, no matter if it 
is active or not. 

NAVIGATION 

Web Research window operates in a way very similar to stand-alone browser. To display any web page just 
type the URL address to "Address" field and press ENTER (RETURN) key. To navigate back and forward in 
the history use <- and -> buttons. 
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To close currently displayed page use regular window close X button as shown In the picture above 

DEFINING YOUR OWN WEB RESEARCH PLACES 


In addition to web-research pre-defined pages you can define any number of your own places. To do so use 

Tools->Customlze menu, Web Pages tab. 



To add new place press New button, then type the URL template In the URL field and web page description In 

the Description field. 

The URL template Is the web address In that has parts that depend on selected symbol. The URL template Is 
parsed by AmiBroker to make actual URL to the web page. For example to see Yahoo's profiles page you can 
use following URL template: 


http ://blz.yahoo.com/p/{tO}/{t}.html. 
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Symbols enclosed In brackets {} define fields which are evaluated In execution time. {tO} symbol Is evaluated 
to the first character of the ticker name and {t} Is evaluated to the whole ticker name. So If AAPL Is selected 
AmiBroker will generate following URL from above template: 

http://blz.yahoo.eom/p/a/aapl.html 

Then AmiBroker uses bullt-ln web browser (Web Research window) to display the contents of the page. 

Special fields encoding scheme 

As shown In above example template URL can contain special fields which are substituted at run time by 
values corresponding to the currently selected symbol. The format of the special field Is {x} where x Is 
describes field type. Currently there are three allowable field types: ticker symbol In original case {t}, ticker 
symbol In lowercase {s}, ticker symbol In UPPERCASE {S}, alias {a}, web Id {i}. You can specify those fields 
anywhere within the URL and AmiBroker will replace them with appropriate values entered In the Information 
window. You can also reference to single characters of ticker, alias or web Id. This Is useful when given web 
site uses first characters of, for example, ticker to group the html files (Yahoo Finance site does that), so you 
have files for tickers beginning with 'a' stored In subdirectory 'a'. To reference to single character of the field 
use second format style {xn} where x Is field type described above and n Is zero-based Index of the character. 
So {aO} will evaluate to the first character of the alias string. To get first two characters of a ticker write simply 
{tO}{t1}. Note about web Id field: this new field In Information window was added to handle situations when 
web sites do not use ticker names for storing profile files. I found some sites that use their own numbering 
system so they assign unique number to each symbol. AmiBroker allows you to use this nonstandard coding 
for viewing profiles. All you have to do Is to enter correct IDs In Web ID field and use appropriate template 
URL with {i} keyword. 

Pages stored iocaiiy 

You may want to have all pages stored on your local hard disk. This has an advantage that profiles are 
accessible Instantly but they can take significant amount of storage space and you will need to update them 
from time to time. To access locally stored files use the following template URL (example, C: denotes drive): 
flle://C:\the_folder_wlth_proflle_flles\{t}.html. You are not limited to HTML files, you can use simple TXT files 
Instead. Then create (or download) the .html (or txt) files for each symbol In the portfolio. These files should 
obey the following naming convention: <tlcker>.html. So for example for APPLE (ticker AAPL) the profile 
should have the name AAPL.html (or AAPL.txt) 

Web-based profiies 

If you want to display the profiles from remote web pages you will need to find out how they are accessible 
(the URL to the web page) and how the data for different symbols are accessible. I will describe the problem 
on the example of Sharenet (www.sharenet.co.za) site providing the data for companies listed on 
Johannesburg Stock Exchanges. Sharenet provides company Information that Is accessible at the following 
address (URL): 

http://www.sharenet.co.za/free/free_company_na.phtml?code=JSECODE&scheme=default 

The problem Is that database provided by Sharenet uses long ticker names and JSECODE Is a short symbol 
code. For example for "Accord Technologies" company the ticker In Sharenet database Is ACCORD but the 
code Is ACR. To solve the problem we will need to use Web iD field In the symbol Information window. If you 
have Sharenet database just choose the ACCORD from the ticker list, open Symbol->lnformation window and 
enter ACR to the Web iD edit box and click OK. Then enter the following URL template to the URL edit box: 
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http://www.sharenet.co.za/free/free_company_na.phtml?code={i}&scheme=default 

To be 100% sure please select the text above with a mouse. Then copy It to the clipboard (Edlt->Copy, 
CTRL-C). Then switch to AmiBroker and click on the Profile URL edit box. Delete everything from It and press 
CTRL-V (this will paste the text). Type "Sharenet" Into Description field. 

Please note that we have used {i} special field In the template that will be replaced by AmiBroker with the text 
entered In the Web ID field of the symbol Information window. Now please select File->New->Web Research 
and pick Sharenet from Address combo box. You should see the profile for ACCORD company. 

You can also delete any entry by selecting It from the list and pressing Deiete button. You can change the 
order In which pages appear In the Web Research address combo using Move Up and Move Down buttons 
(select the Item first and then use buttons). 

Configuration data are stored In webpages.cfg plain text file that holds any number of URL templates In the 
form of: 

URLTemplate|Descrlptlon 
(each entry In separate line) 
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Using account manager 

Account manager is a tool for keeping track of your trades and your performance. You are able to enter trades 
you make, deposit/withdraw funds, check the statistics and historical performance. All transactions are 
recorded so you will never forget what happened in the past. Account manager allows you to keep track of 
unlimited number of accounts. 

New account manager replaces and enhances functionality provided by portfolio manager in pre-4.90 
versions. 

CREATE A NEW ACCOUNT 

Use File->New->Account menu to create new account 


A AmiBroker-DOWJONE 
^ File Edit View Insert 


□ 




H] New Database... 

10 New Default Chart 
Q New Blank Chart 
a New Blank Pane 


m 

New Account 

N 

e 

New Web Research 



er 

o\ 

vi 

»s1 

iv 

iti 


FUNDING AN ACCOUNT 

Before you do any trading, you have to fund your account. To do so press "FUNDING" button on the account 
manager toolbar, then select "Deposit" as operation type, enter the DATE when you have funded your 
account and enter the amount. 

Note that funding date must PRECEDE any trading, as account manager won't allow you to trade prior to 
funding date. Initial deposit will show as "initial equity" in summary tab. 


^ '^DJl (Daily V^Q Accountl x | 
^ Buy ▼ Sell j^Fundi^ S 



THE SETTINGS 

It is good idea to go to "Summary tab" and setup commissions and trading mode. If this account is used for 
End-of-day trading you should set "EOD Mode" to YES, otherwise (if you trade intraday) you should set "EOD 
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Mode" to NO. Depending on this setting Buy/Seii diaiogs wiii aiiowyou to enter date and time of the trade or 
oniy date. 



Commission tabie allows to enter both per-share (per-contract) commissions and commissions that are 
expressed as percent of trade value. Or a combination of both. You can also set minimums and maximums 
expressed in dollar amount and/or percent of trade value. For example if your broker may use 0.01$ (one 
cent) per share commission, then you would use PerShare = 0.01 and %OfTradeValue = 0. If your broker 
uses say 0.2% of trade value then you would use PerShare = 0 and %OfTradeValue = 0.2; 

Practical example: Interactive Brokers default commission for U.S. stocks is: 0.005 per share but not less than 
1 dollar and not more than 0.2% of trade value. Appropriate settings for such schedule are shown in the 
screenshot above. 

Commission table works as follows: first sum of per-share commission and % of trade value is calculated. 
Then the result is checked against minimum and maximum limits and if calculated value exceeds the limit 
then commission is set to value of such the limit, otherwise calculated value is used without change. 

Summary page contains a little bit of basic statistics as well. 
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ENTERING TRADES 

Once you funded an account you can enter trades.To buy (enter long position or cover short position ) click on 
"BUY" button. 


SAccountl 


■i 

▼ Sen ©Funding 

ID 

Date/Time 

Type Symbol 


wr 


Ticker: 

Date: 

Price: 

Qty: 

Net market value: 
Commission: 
Margin deposit: 

Currency: 

FX rate: 



38.77 


500 

Set to Max. 

19385 

(futures only 

2.5 



(foreign /non-base/ 
currency not 
implemented yet) 


Then in the Buy dialog you need to select the symbol, the trade date/time. Once they are entered AmiBroker 
will display price of given symbol at the selected date/time (or preceding one if no exact match is found). It will 
also calculate maximum possible quantity taking price and available funds into account. 

You can change the price and quantity manually. 

All other values (net market valye, commission, market deposit, currency, fx rate) are calculated or retrieved 
automatically from Symbol->lnformation page. Once values are good, click OK to confirm transaction. If you 
made mistake, you can press UNDO (Edit->Undo) to revert last transaction. 

Similar procedure is for selling (entering short positions or closing longs) with the exception that you should 
press "SELL" button instead. 

All transactions that you made are listed in the "Transactions" sheet. All open positions are listed in "Open 
Positions" sheet. If you enter the trade for symbol that has position already open, AMiBroker will adjust "open 
positions" accordingly (perform scaling in/out). Once open position is closed it is removed from "open 
positions" list and moved to "Closed trades" sheet. 


CREATE A NEW ACCOUNT 


90 

















































AmiBroker 6.00 User's Guide 


Tutorial 



After each transaction, "Equity history" sheet is updated with current account equity vaiue and aiso 
"Summary" page is updated with basic open/iong/short trade stats.(More stats are to come). 

IMPORTANT 

You have to remember that you must enter aii transactions in chronoiogical manner(oidest first, newest last), 
as account manager won't allow you to add trades out-of-order. If you make mistake, there is one-level undo 
that you can use to revert to state before last transaction. If you made more mistakes, the only option is to 
close account without saving and re-open original file. 

SAVING YOUR ACCOUNT DATA 

To save edits made to account use File->Save (or File->Save As to save under new name). Note that 
account files are NOT encrypted now, and it is quite easy to read the file for everyone who has the access 
to it. So make sure not to leave your files on some public computer. Password protection/encryption is 
planned but NOT implemented yet. 

OPENING PREVIOUSLY CREATED ACCOUNT 

To open account file, go to File->Open, in the File dialog, select "Account (*.acx)" from "Files of type" 
combo-box, and select the account file you want to load. 
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MULTIPLE ACCOUNTS 

You can create/open multiple accounts at once (just use File->New->Account, File->Open many times). 
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Using fundamental data 

AmiBroker 4.90 adds ability to use 32 fundamental data items. Fundamental data can be automatically 
downloaded for all U.S. stocks for free using AmiQuote. New Information window allows you to view these 
items, while new AFL function: GetFnData allows to access fundamentals programmatically. 

INFORMATION WINDOW 


To display fundamental data in Information window, please use Symbol->lnformatlon menu. This will open 
Information window with several fundamenta data fields as shown in the picture below (if you created new 
database, it probably will not have these data present initially and you would need to download them) 


A AmiBroker - [^DJI - DOW JONES INDUSTR- Dc 
^ File Edit View Insert Format Syrr 


n i^ Q @ # 

tiQ ‘ 



Information 


4 

X 

Dividend Yield 

N/A 


> 

0 Statistics 




Shares Out. 

0 



Shares Float 

0 



% Held by Insiders 

0 



% Held by Institut 

0 



Shares Short 

0 



Shares Short Prior 

0 



Beta 

0 



e Financials 




EPS 

0 



EPS Est. Current V 

0 



EPS Est. Next Yea 

0 



EPS Est. Next Qua 

0 



Forward EPS 

0 



Book Value (p.s.) 

0 



PEG Ratb 

0 



Profit Margin 

0 



Operating Margin 

0 



lyr target price 

0 



Return on Assets ( 

0 



An CmiiKr/ 

n 




Shares Out. 

Number of shares of common stock 
currently outstanding. 

JThis help fiel^provides short 
Lay... f explanation 


For Help, press H 


DOWNLOADING FREE FUNDAMENTAL DATA FROM YAHOO 

New version of AmiQuote now features ability to download free fundamental data from Yahoo Finance web 
site. This is implemented using 2 different Yahoo pages: 

1 . Yahoo Fundamental - Basic data source (free basic fundamental data, 200 symbols in one request). 
Data are retrieved from the following URL: http://finance.yahoo.com/q?s={Ticker} (Download data 
link). 
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That page provides the following data: 

EPS (ttm) 

EPS Est Current Year 
EPS Est Next Year 
EPS Est Next Quarter 
PEG Ratio 
Book Value 
EBITDA 
Sales Revenue 
Dividend Pay date 
Ex Dividend date 
Dividend Per Share 
1yr Target Price 
Shares Float 
Shares Outstanding 

Explanation of values: http://help.yahoo.com/help/us/fin/quote/quote-03.html 
2. Yahoo Fundamental - Extra data source (extended fundamental data, 1 symbol in one request, 
more data - available in registered version only). 

Data are retrieved from the following URL: http://finance.yahoo.com/q/ks?s={Ticker} (Key Statistics 
page) 

That page provides following data: 

Forward P/E 
PEG Ratio 
Profit Margin 
Operating Margin 
Return on Assets 
Return on Equity 
Revenue (ttm) 

Qtrly Revenue Growth 
Gross Profit 
EBITDA 
(Diluted) EPS 
Qtrly Earnings Growth 
Book Value Per Share 
Operating Cash Flow 
Levered Free Cash Flow 
Beta 

Shares Outstanding 
Float 

% Held by Insiders 
% Held by Institutions 
Shares Short (prior month) 

Shares Short 

Forward Annual Dividend Rate 
Trailing Annual Dividend Rate 
Dividend Date 
Ex-Dividend Date 
Last Split Factor 
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Last Split Date 

Explanation of values: http://help.yahoo.com/help/us/fin/research/research-12.html 

IMPORTANT NOTE: Unregistered version of AmiOuote allows you to download 
fundamental-ex data for first 20 tickers in the list. To download data for more symbols you 
need to register AmiOuote. 

Downloading data is easy and staightforward: 

1. Run AmiOuote 

2. In AmiOuote, select Tools->Get tickers from AmiBroker 

3. Select Yahoo Fundamentai - Basic or Yahoo Fundamentai - Extra from Source drop down list 

4. Make sure that Automatic import box is checked 

5. Press Green Arrow to Start Downioad 



Once download is complete, you should see fundamental data updated in Information window in AmiBroker. 

ACCESSING FUNDAMENTAL DATA FROM FORMULA (AFL) LEVEL 

To access fundamental data from AFL level you can use new GetFnData function. It has quite simple syntax: 
GetFnDataC'field") 

where "field" is any of the following fundamental data field supported. For detailed list please see GetFnData 
function reference. 

The function returns the number (scalar) representing current value of fundamental data item. There is no 
history of values (no arrays are returned), so it is useful for scanning, explorations (for current situation), 
market commentary / interpretation, but not for backtesting. Example exploration formula looks as follows: 

AddColumn ( Close / GetFnData ( "EPS" ) , "Current P/E ratio" ); 

AddColumn ( Close / GetFnData ( "EPSEstNextYear" ) , "Est. Next Year P/E ratio" ); 
Filter = Status ("lastbarinrange"); 
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IMPORTING FUNDAMENTAL DATA FROM OTHER SOURCES 

AmiBroker allows also to import fundamentals using its flexible ASCII importer and/or OLE interface as all new 
fields are exposed as properties of Stock object. 

ASCII importer $FORMAT command now supports the following extra fields for fundamental data: 

DIV_PAY_DATE 

EX_DIV_DATE 

LAST_SPLIT_DATE 

LAST_SPLIT_RATIO 

EPS 

EPS_EST_CUR_YEAR 

EPS_EST_NEXT_YEAR 

EPS_EST_NEXT_QTR 

FORWARD_EPS 

PEG_RATIO 

BOOK VALUE (requires SHARES_OUT to be specified as well) 

BOOK_VALUE_PER_SHARE 

EBITDA 

PRICE_TO_SALES (requires CLOSE to be specified as well) 

PRICE_TO_EARNINGS (requires CLOSE to be specified as well) 

PRICE_TO_BV (requires CLOSE to be specified as well) 

FORWARD PE (requires CLOSE to be specified as well) 

REVENUE 

SHARES_SHORT 

DIVIDEND 

ONE_YEAR_TARGET 

MARKET_CAP (requires CLOSE to be specified as well - it is used to calculate shares outstanding) 

SHARES_FLOAT 

SHARES_OUT 

PROFIT_MARGIN 

OPERATING_MARGIN 

RETURN_ON_ASSETS 

RETURN_ON_EOUITY 

OTRLY_REVENUE_GROWTH 

GROSS_PROFIT 

OTRLY_EARNINGS_GROWTH 

INSIDER_HOLD_PERCENT 

INSTIT_HOLD_PERCENT 

SHARES_SHORT_PREV 

FORWARD_DIV 

OPERATING_CASH_FLOW 

FREE_CASH_FLOW 

BETA 

Note that if you want to import only fundamental data with ASCII importer (without quotes) you need to use 
SNOQUOTES 1 command. See Formats\aqfe.format and Formats\aqfn.format files for example usage - these 
are files actually used by AmiOuote to implement automatic import of fundamental data downloaded from 
Yahoo. 
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The names of extra properties of Stock object are the same as used by GetFnData function and they are 
iisted in detaii in OLE objects reference. 
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Using New Analysis window 

Introduction 

New Analysis window introduced in version 5.50 (first time actually in 5.41.0 BETA) brings the following 
improvements over old Automatic Analysis: 

• multi-threaded operation = speed - new Analysis window uses all available CPUs/cores to execute 
formulas in many threads in parallel providing significant speed ups. For example on 4 core Intel i7 
that can run upto 8 threads, it can run upto 8 times faster than old Analysis window. Exact speed up 
depends on complexity of the formula (the more complex it is, the more speedup is possible), amount 
of data processed (RAM access may be not as fast as CPU thus limiting possible speed gains). 

• non-blocking operation - you can now view, scroll and sort results of analysis while they are still 
generated, also as user interface thread is not used for processing for most part, charts and other 
GUI-driven program parts are way more responsive than with old automatic analysis 

• multiple instances - you can run more than one instance of New Analysis at a time, so you can run 
many scans/backtest/explorations/optimizations in parallel without waiting for one to complete 

• slicker user interface - New Analysis window can act as tabbed document, can be floated, buttons 
can be re-arranged for better workflow. There is way more space for the result list, extra information 
about execution is provided on the new "Info" tab. Also walk-forward results are now displayed within 
New Analysis window for less clutter. 

User interface 

You can open New Analysis window in a number of ways: 

1. click on the New Tab (h-) button and selecting New Analysis 

5~AmiBroker - ;@NQ# - E-MINI NASDAQ 100 STKIDX DEC 2011 


File Edit View Insert Format Symbol Analysis Tc 


Dcsyfa m % 

o a a = 

ii 

/ @NQ# (lOOR) X 1 O 

New Tab button 



or 

2. File -> New -> New Analysis menu 
or 

3. Analysis-> New Analysis menu 
or 

4. right click on the formula in the Charts window and selecting Analysis 
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0 (_J Systems | 

f - 


Insert 

Insert Linked 

Overlay 

f ExampI 
CJ Test 


Anal^is 



Edit 

Rename 

Delete 

New t 

Refresh 


or 

5. from the Formula Editor, pressing Send to Analysis button 


, [Formulas\Custom\Unnamed 436.afl] - Formula Editor 


File Edit Tools Help 


DqSB ^ Unnamed 436 


*ty t-a - 


V 

V 



Send to Analysis window 


Scan 

Exploration 

Backtest 

Optimization 


Check 


Basically the user interface for New Analysis window is functionally similar to old automatic analysis and looks 
as follows: 
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^ AmiBroker - [Ana Click on (+) button to open New Tab for Analysis 

-- (as well as new Chart, Account or Web Research 

File Edit View Symbol Analysis VTooIs Window" Help 

‘o\c r- ©NQ# - _ ^ Pick formula Edit 

Report "Settings ~Parameters ~ Formula from file “formula 

-V' 




Action buttons IP?' ^ Analysisl x 

. ml^an (fe^p7or^^BacidMt~^Optimize » □ » J?} '• P=^_ Formula Formulas\Custom\EdwardTe 
Apply to *Fjlter " T Range From-To dates ^ 2009-01-01 2012-01-01 _ 

Symbol 


i-CLw 



+ CL» 
©NQJ' 


Apply To 

1 * All symbols _ 

•I * Current symbol lort 
Filter _ ,ng 

Short 
Long 
Short 
Short 
Short 
Long 
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Long 
Long 


©TFSJr 

©EMD» 

©TFS» 

©NQ» 
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©EMD# 

*CL» 

©NQ» 

©TFS» 

■rCL» 

Result list 


Date 

2009-01-01II 
59-01-011! 
59-01-01 Z 
^2009-01-01 Z 
2009-01-02 01 
2009-01-02 0: 
2009-01-02 01 
2009-01-02 01 
2009-01-02 01 
2009-01-02 01 
2009-01-021( 
2009-01-02 1( 
2009-01-02 o: 
2009-01-021( 



Profit 

-0.73 

-0.32 

-0.52 


% Profit 
-0.07% 
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b: s 


Contri 


Info tab 

log of operations including 
summary of backtest, number of 
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'ss'ww* Long j 
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41.75 
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□ 
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-7.25 
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o 

1,211.25 

2009-01-021( 
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A 
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2009-01-04 11 
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31.75 
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41.81 
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0.51% 

' 
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1.30 

0.13% 
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2009-01-05 01 
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0.53% 

-0.25 
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1,249.75 
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Basic operations 

Selecting the symbol to apply analysis to. 

Ciick on the drop down arrow in the Apply to combo to seiect operation mode: All symbols / Current symboi 
/ Filter 


HI Scan licr'Explore >^Backte 

Apply to 



£ 

< 

*AII symbols ^ 

'Current 



Defining Filter 

If Apply To is set to Filter, Anaiysis window wili be run on the symbols that match filtering criteria that are 
definable in the Filter Settings window. To open Filter Settings window press Filter button 
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Defining date/time Range 

Click on the drop down arrow in the Range combo to select range selection mode: All symbols / N recent 
bar(s) / N recent day(s) / From-To dates 


;t ^Opt imize □ , * , p= _ Formula FormulasNCuston 


Range 


From-Co 


All quotes 
1 recent bar(s) 
1 recent day(s) 


dates 


2009-01-01 2012-01-01 □ 


date Ex. Price %chg 

19-01-011! 42.67 -1.68% 

19-01-01 2. 42.99 0.75% 


Prof 

-0.7 

- 0 .= 


The 'N' can represent any number. For example to define range of 15 recent davs . select 1 recent day(s) first 
and then type in 15 and press ENTER. You will see the text automatically update to 15 recent day(s). 
Remember you don't need to type whole thing, just a number is perfectly enough. 


Viewing reports / Running Report Explorer 

To view the report from last backtest, click on the Report button. To run the Report Explorer use a Report 
button drop down menu as shown below 


- P= ^ Form ula 
!~~l View last report 
Report Explorer 


Changing settings / options 

To change backtester settings click on the Settings button. To turn on/off additional options like: 

• Sync chart on select 

• Wait for backfill 

• Auto repeat Scan/Explore 

• Auto repeat interval 

click on the drop down arrow on the Settings button to display the menu as shown below 

■ » - Formula Formulas\Custom\EdwardTe 

(Ji Settings 

[ Sync chart on select ^ 

; I vT 1 Wait for backfill (slow, RT sources only) ’ 

^ Auto-repeat Scan/Explore ’ 

^ Interval: 5min 

Afj /n virv viv. 
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Auto-repeat interval can be entered in the Interval field. Note that plain numbers (like 5) represent minutes. 
To get seconds you need to enter 5sec or 5s and press ENTER 


Running Walk forward Test 

Click on the arrow on the Optimize button to display the menu as shown below and select Walk-Forward 


^Optimize r , 

& 


ji- 


Optimb 
Walk-Forward 
3D Optimization chart 


The results of Walk forward test will be displayed in Walk Forward tab (see bottom of Analysis window). 


Displaying 3D optimization chart 

To display 3D optimization chart, first run the Optimize that has exactly two optimization parameters and then 
click on the arrow on the Optimize button to display the menu as shown above and select 3D Optimization 
Chart. 


Displaying Equity charts 


ii ^n - - I Fo r 

Ji Portfolio Equity 
Individual Equity 


Equity charts (portfolio and individual) can be added to chart windows using Portfolio Equity / Individual 
Equity options as shown above. 


Exporting and importing result list 

To export data to CSV file or HTML file use File -> Export HTML/CSV menu (from the main window). To 
import previously exported HTML file use Flle->lmport HTML... as shown in the picture below. Note that 
these menu items appear only if you have New Analysis window active. 
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A AmiBroker - [Analysisl] 


File Edit View Symbol Analy 


New 

Open... Ctrl+0 

Close 

Open Database... 

Save Database 
Save Database As... 


y 

& 


Save 
Save As... 

Save All 

Database settings... 


Ctrl+S 


Import HTML... 


1—t HTML/CSV... ^ 


Import Wizard... 

Import ASCn... 

sIS Import MetaStock data... 

Recent files t 

Exit 


User interface 


103 



















AmiBroker 6.00 User's Guide 


Tutorial 


How to get quotes from various markets 


REAL-TIME DATA (Professional Edition only) 


Country/Exchange 

Data 

source 

Type 

Price 

Download Update 

Comments 



Real time 
streaming 
quotes. 





All US Stock and 
Futures markets. 


Tick, 5-, 15- 
second 

1-, 5-, 15-, 
60-minute 
intraday 





FOREX 

eSignal 

More pricing 
information 

Automatic 

Automatic 

Dedicated RT 
plug-ln - details 
here 

Major European 
markets. 


10-day tick, 
60-day minute 
bar backfill. 







Historical EOD 
(10 years) 







500 symbols, 
tick, 5-sec, 
15-sec, 

1-minute and 

$63/month basic 




US stocks, futures, 
options, FOREX 

DTN 

IQFeed 

up, 

120 days 

fee 

More pricing 

Automatic 

Automatic 

Dedicated RT 
plug-ln - details 
here 



backfill 

information 






(note: unfiltered 
feed) 







100 symbols 
streaming RT, 

$10 per month in 




US, Canada and 
European 
exchanges 


1-sec, 1-minute 

commissions, or 



Dedicated RT 

Interactive 

Brokers 

bars and up. 

30 day backfill 

free if your 
monthly 

commissions are 

Automatic 

Automatic 

plug-ln 

- details here 



available for 

IB customers 

>$30 




All US Stock and 

myTrack 

Real time 

See service plans 

Automatic 

Automatic 

Dedicated RT 

Futures markets. 


streaming 




plug-ln - details 



quotes. 




here 

Major European 







markets. 


1-, 5-, 15-, 
60-minute 
intraday 
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15-day minute 
bar backfill. 

Historical EQD 
(15 years) 





Various exchanges 
/ various sources 

(detaiied iist) 

Quote 

Tracker 

Real time 
streaming 
quotes. 

1-, 5-, 15-, 
60-minute 
intraday 

Limited (max. 5 
days, usually 
one day) 
backfills 

Various (including 
free) 

More pricing 
information 

Automatic 

Automatic 

Dedicated RT 
piug-in - details 
here 

Warsaw Stock 
Exchange 

Statica 

30/90 days 
intraday + 
mixed mode 
EOD 


Automatic 

Automatic 

Dedicated RT 
piugin - details 
here 

Various 

(any data source 
that has DDE 
interface) 

DDE link 

just streaming 
quotes, no 

backfiii 

Free 

Automatic 

Automatic 

Dedicated RT 
piug-in 

- details here 


END-OF-DA Y, INTRADA Y DELA YED DA TA 


AmiBroker can handle virtually EVERY exchange in the world if only plain ASCII data for that exchange are 
available. The table below list some of the data sources. 

AmiBroker comes preloaded with sample DJIA components database. You can update this sample database 
(and any other US & Canada market databases) with a new quotes using supplied AmiQuote program. 

Later in this tutorial you will find detailed instructions on how to use AmiQuote. 

Quote sources for AmiBroker (this list is not complete - keep in mind the fact that almost any source can be 
used). Use links to find out more (note that some links require internet connection) 


Country/Exchange 

Data source 

Type 

Price 

Downioad 

Update 


Yahoo Finance 

Historical + 

Current EQD 

Free 

Automatic 

(AmiQuote) 

Automatic 


Google Finance 

Historical EQD 

Free 

Automatic 

(AmiQuote) 

Automatic 


MSN Money Central 

Historical EQD 

Free 

Automatic 

(AmiQuote) 

Automatic 
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Norgate Investor 
Services (Premium 

Data) 

Historical EOD + 
Daily updates + 
Sectors / 

Industries / etc + 
Delisted symbols 

Paid 

Automatic 

Automatic (via 
MS plugin) 

Detc 

here 









TC 2000/TCNet 
(stocks) 

TC2000 Mutual Funds 

Historical + 

Current EOD + 
Sectors/Industries 

Paid 

Automatic 

Automatic 

Dire 

- de 

here 


Fastirack (mutual 
funds) 

Historical + 

Current EOD + 
Families 

Paid 

Automatic 

Automatic 

Dire 

- de 
here 


FOREX 

Historical EOD + 
Intraday 

Free 

Automatic 

(AmiQuote) 

Automatic 

Detc 

des( 

here 


CSI 

http://www.csidata.com 

Historical EOD 

Paid: 

Details 

here 

Automatic 

Automatic 

Upd 

usin 

Unfc 

Adv, 
















Norgate Investor 
Services 

Historical EOD 
(also US stock 
and future 
markets) 

Paid 

Automatic 

Automatic (via 
MS plugin) 

Detc 

here 

Australia 

(Australian Stock Exchange) 

Bodhi Freeway 

Historical 

Paid 

Automatic 

(Bodhi 

downloader) 

Automatic (via 
METASTOCK 
plugin) 

How 

setu 

to M 
data 


Yahoo Finance 

Australia 

Current EOD 

Free 

Automatic 

(AmiQuote) 

Automatic 

Detc 

des( 

here 

50+ International 
Exchanges 

Yahoo Finance 

Historical + 

Current EOD 

Free 

Automatic 

(AmiQuote) 

Automatic 

Detc 

des( 

here 

Poland 

(Warsaw Stock Exchange) 

Bossa.pl 

Historical + 

Current EOD 

Free 

Automatic 

(script-based) 

Automatic 

(script-based) 

Detc 

new 

South Africa 

(Johannesburg Stock 
Exchange) 

Sharenet 

Historical + 

Current EOD 

Paid 

Automatic 

(Sharenet 

downioader) 

Automatic 
(script- based) 

Sha 

Ami 

corn 

Investor Data 

Historical 

Paid 

Manual 

Manual 


Holand (Amsterdam - 
Euronext) 

PF-online 

Historical + 

Current EOD 

Free 

Manual 

ASCII Import 
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How to set up AmiBroker with eSignal feed (RT version only) 


Requirements 

IMPORTANT: You have to have eSignal application installed on your machine and a valid eSignal 
subscription. 

One-time setup 

To use AmiBroker with eSignai feed you will need to perform a one-time setup described below: 


• Run AmiBroker 

• Choose File->New database 

• Type a new folder name (for example: C:\Program Files\AmiBroker\eSignal) and click Create as 
shown in the picture below: 



• Choose eSignal RT data Plug-in from Data source combo and "Enable" from Local data storage 

• Enter appropriate number of bars to load: 

90000 for 1-minute database combined with long history daily database 

• Click on Configure button to show plugin configuration dialog as shown below 
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Enter here your eSignal user and password (if you have eSignal properly installed AmiBroker will 
pre-set these fields to user/password entered in eSignal software). You may also adjust Number of 
symbols. This should not exceed your account limit and you may consider lowering this value if you 
want to use AmiBroker in parallel with another Data manager client application. (If you exceed the 
limit of your subscription AmiBroker will re-adjust this number down) 

Click OK 

• Now choose Base periodicity. Note that recommended periodicity is 1 minute, but you can select 
all base periods starting from tick upto hourly. 

Note that selecting tick, 1-second, 5-seconds or 15-seconds periodicities will cause transmission of 
huge amounts of data from eSignal servers (for actively traded security it can be several megabytes 
for just one symbol and very few days of history). If you have a modem connection this setting is 
highly discouraged. Also if you should consider using 1-second bars instead of pure ticks since this 
mode is faster. 

Also note that to get long end-of-day histories together with intraday data you should go to 
File->Database Settings->lntraday Settings and turn ON "Allow mixed EOD/Intraday data" option. 

• Click OK. 

From now on your AmiBroker reads quotes directly from the eSignal. 

To learn how to use AmiBroker in Real Time mode read this tutorial article. 
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How to set up AmiBroker with myTrack feed (RT version only) 

Note: the most recent version of this document can be found at: http://www.amibroker.com/mytrack.html. 
Please check this page for updates. 

Requirements 

IMPORTANT: You have to have myTrack subscription with SDK feature enabled. 

To have the SDK working, run the myTrack program, click on CHAT, then on Entitlements and then on 
Features, check the box SDK. 


One-time setup 

To use AmiBroker with myTrack feed you wiii need to perform a one-time setup described beiow: 


• Run AmiBroker 

• Choose File->New database 

• Type a new folder name (for example: C:\Program Files\AmiBroker\myTrack) and click Create as 
shown in the picture below: 



• Choose myTrack RT data Plug-in from Data source combo and "Enable" from Local data storage 

• Click on Configure button to show plugin configuration dialog as shown below 
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Enter here your myTrack user and password . You may also adjust Number of symbols. This should 
not exceed your account limit. 

Click OK 

• Now choose Base time interval. Note that supported bar intervals are 1 minute and daily 
(end-of-day). 

If you want to have long daily histories AND intraday charts you should consider running TWO 
instances of AmiBroker. One for EOD charts and second for intraday charting. Both instances may 
use myTrack as a data source. 

• Click OK. 

From now on your AmiBroker reads quotes directly from the myTrack. 

To learn how to use AmiBroker in Real Time mode read this tutorial article. 
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How to use AmiBroker with external data source (Quote Tracker) 

IMPORTANT: You need QuoteTracker 2.4.9C OR ABOVE (3.1.0 recommended). Can operate on standard 
edition but AmiBroker RT is recommended. 


VERY IMPORTANT: QuoteTracker has to be CONFIGURED so Its Internal server Is running. Click here 
for the explanation. 

CAVEAT: QuoteTracker should be considered as poor-man's real-time substitute. Its performance can not be 
compared to true real-time feed as eSignal or myTrack that offer very reliable, long back-fills and true 
tick-by-tick updates. 

QuoteTracker plugin currently works in TWO modes: 

daily mode - plugin adds and updates the last (todays) bar with the most recent quotes in nearly real time- it means that you have 
to use it in conjunction with already existing end-of-day database. 

intraday mode - plugin provides one day intraday historical data - more days can be accumulated if 
AmiBroker with OT is launched everyday so AmiBroker can save histories to its local database. 

One-time setup 

Make sure that your QuoteTracker has enabled QT HTTP server: Options->Edit Preferences : Misc tab: HTTP Server Settings 
If you are using unregistered version of QuoteTracker make sure you click on ads often enough. 

To use an external data source with AmiBroker you will need to perform a one-time setup described below: 


Run AmiBroker Choose File->New database Type a new folder name (for example: C:\Program 
Files\AmiBroker\NewData ) and click Create as shown in the picture below: 
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Choose appropriate entry from Data source combo: 

• Quote Tracker users select "Quote Tracker plug-in" as a Data Source and "Enable" from Local 
data storage 

Click on Configure button to show plugin configuration dialog as shown below 



You may also click on Retrieve button to pre-fill AmiBroker database with symbols already present in 
QuoteTracker. From now on your AmiBroker reads quotes from Quote Tracker in nearly real time. 

To learn how to use AmiBroker in Real Time mode read this tutorial article. 

Description of QuoteTracker plugin configuration options 

QT plugin configuration dialog looks as follows: 
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Here is a description of the settings: 

QuoteTracker server port: defines the port on which QT HTTP internai server is visibie. 16239 is the defauit 
vaiue used by QuoteTracer and you shouid not change this in most cases. If in doubt piease check 
QuoteTracker HTTP server settings: Options->Edit Preferences : Misc tab: HTTP Server Settings menu of QT. 

Refresh inteval - defines how often AmiBroker wiii ask QT for quotes. 5 second is defauit. You may consider 
changing it to 10 or 15 seconds in case you have iots of symbois and slow machine 

Auto-add symbols from AmiBroker - if this option is turned ON (by default it is) if you switch in AmiBroker to 
the symbol that is not present in any of QT portfolios - it will be automatically added to default QT portfolio. It 
also applies to any other kind of access (for example if you try to import symbols to AmiBroker and they do not 
exist in QT - they will be added if this option is turned on). Switching it QFF disables auto-add feature. 

Max. number of added symbols - defines the maximum number of symbols that get added using auto-add 
feature descibed above. This protects QuoteTracker from becoming overloaded (AmiBroker can handle tens 
of thousands symbols with ease but QuoteTracker can NQT) 

Use optimized routine for Intraday data retrieval - turning this on (default, recommended) significantly 
speeds-up data retrieval in intraday modes. If this option is enabled and AmiBroker already has partial 
intraday data for today AmiBroker asks QT just for a few last time and sales records that occurred since last 
update upto current time, if this option is disabled AmiBroker always asks QT for time&sales records from 
entire day. 

Time difference relative to US Eastern time - the time difference (in hours) between your local time and US 
Eastern time (EST). This field is needed because QuoteTracker's server reports all times in EST time zone. 
This means that if you live in Australia QuoteTracker will report ASX quotes with EST time zone and they will 
be 15 hours off from your local time. While AmiBroker has the setting for shifting intraday charts and this is not 
a problem when running Intraday mode, it becomes a problem when using daily (EQD) mode because quotes 
reported by QuoteTracker are one day off then. This setting solves this as AmiBroker adds the number of 
hours entered here to the time reported by QuoteTracker to get the valid date of quote in daily mode. This 
field is filled in with the difference calculated using your Windows Time settings. 

Retrieve symbols from QuoteTracker - pressing "Retrieve" button adds all symbols present in 
QuoteTracker to AmiBroker symbol list. 
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How to set up AmiBroker with IQFeed feed (RT version only) 

Note: the most recent version of this document can be found at: http://www.amibroker.com/iqfeed.html . 
Piease check this page for updates. 

Requirements 

If you don't have IQFeed CONNECTION MANAGER already Installed you have to Install It first. You can 
download IQFeed client setup from here (version 4.2.0.7). 

http://www.amibroker.com/video/IQFeed.html 

To use AmiBroker with IQFeed you will need to perform a one-time setup described below: 

• Run AmiBroker 

• Choose File->New database 

• Type a new folder name (for example: C:\Program Files\AmiBroker\IQFeed ) and click Create as shown in the picture 
below: 



• Choose DTN IQFeed data Plug-in from Data source combo and "Enable" from Local data storage 

• Now choose Base time interval. Select 1-minute 

• Enter appropriate number of bars to load: 

100000 for 1-minute database to get max history (8 months) available from IQFeed 

• Click on "Intraday Settings". Check "Allow mixed EOD/Intraday data" box. Click OK 

• Click OK. 
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From now on your AmiBroker reads quotes directly from the IQFeed. 

To learn how to use AmiBroker in Real Time mode read this tutorial article. 
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How to use AmiBroker with Interactive Brokers TWS 

Note: the most recent version of this document can be found at: http://www.amibroker.com/ib.html . Piease 
check this page for updates. 

IB PLUGIN FEATURES SUMMARY: 

• supports upto 100 streaming symbols in real time (equal to IB TWS limit) 

• supports all base time intervals: daily, hourly, 15-,5-,1-minute, 15-,5-second, tick 

• automatic connection (no need to manually "accept incoming connection" in TWS) 

• supports upto 30 DAYS Intraday data BACKFILL In 1-minute bar Interval 

• upto 2000 bars backfill using 1-sec/5-sec/15-second bar intervals 

INSTRUCTIONS: 

NOTE: interactive Brokers TWS is CPU-hungry appiication, therefore for best resuits we recommend using 
machine with 1 GHz processor or faster. 

NOTE 2: There is a VIDEO tutorial showing how to set it up at http://www.amibroker.com/video/ib.htmi 


To use Interactive Brokers data plugin with AmiBroker you need to: 

1. run web-based TWS or download standalone TWS 

2. In TWS, select Configure -> API -> Enable Active X and Socket clients 

Also enter 127.0.0.1 In TWS, Conflgure->API->Trusted IP addresses menu to prevent "Allow 
incoming connection?" dialog. 

3. Run AmiBroker and create new database with Interactive Brokers plugin as a data source, following 
these steps: 

• Run AmiBroker 

• Choose Flle->New database 

• Type a new folder name (for example: C:\Program Files\AmiBroker\IB ) and click Create as shown in 
the picture below: 
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• Choose InteractiveBrokers(r) data Plug-in from Data source combo and "Enable" from Local data 
storage 

• Enter 30000 or more into "Number of bars to load" field 

• Now choose Base time interval. Supported intervals are: EOD, hourly, 15-minute, 5-minute, 

1-minute. Professional Edition of AmiBroker allows also to select Tick, 5-second, 15-second 
intervals. 


Note that backfill is in bar interval of 1-minute or less (TWS limitation). 

If you want to have long daily histories AND intraday charts you should consider running TWO 
instances of AmiBroker. One for EOD charts and second for intraday charting. Both instances may 
use IB as a data source. 

• Click OK. 

From now on your AmiBroker reads quotes directly from the Interactive Brokers. 


HOW TO USE BACKFILL FEATURE 

Backfill feature in plugin 1.3.7 allows to download 24 intraday historical data to fill-in the gaps that may have 
occurred when AmiBroker / TWS is not running. 

IB Backfill feature is configurable from Flle->Database Settings, Configure : 
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Two main backfill-related settings are: 

1. request length 

2. automatic backfill 

When request length is considered, as explained in TWS API Release Notes at: 

http://www.interactivebrokers.com/en/software/apiReleaseNotes/apiBetanotes.php currently IB backfill feature 
is limited to some fixed duration / bar interval ranges. For example you can get maximum 2000 1-second 
ticks, maximum 10000 seconds in 5-second interval (2000 bars), maximum 30000 seconds in 15-second 
interval (also 2000 bars) and maximum of 5 DAYS of 1-minute bars. 

By default AmiBroker uses maximum allowable amounts. 

As for "automatic backfill on first data access" - when it is checked AmiBroker attempts to backfill symbol 
when you display a chart for given symbol (or perform backtest or scan). Please note that TWS API currently 
allows only one backfill at a time so when there is a backfill already running in the background, automatic 
backfill request for next symbol will be ignored, until previous backfill is complete. 

It is convenient to have this option turned on, however it can cause additional load on your internet connection 
because of data needed to be downloaded during backfill process. 

If you switch "automatic backfill on first data access" option off, you will still be able to backfill data for current 
symbol or all symbols in real-time quote window list usign appropriate menu options from plugin status menu. 
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olume Trad... 
.3,892 8 

0 0 


Bid Bid size 
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2.0169 3,000,... 
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2.0167 
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Click with right mouse 
button here to bring up 
the menu 


^ Minimum 

1 day 

5 days 

10 days 



Reconnect 

Shutdown 

15 days 

Backfill Current 

20 days 

Backfill All RT quote window symbols 

25 days 

Cancel Backfill 

30 days 

Rarkfl len^ 
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Backfill Current option allows to force backfill of currently selected symbol, while Backfill All RT quote 
window symbols allow to force backfill of all symbols listed in Real-Time Quote window. Backfill of multiple 
symbols is performed sequentially (one at a time) due to limitations of TWS. 


Backfill length submenu allows to select desired backfill length. 


During backfilling a tooltip pops up informing the user about symbol being currently backfilled and plugin 
status color changes to light blue (turquoise) as shown below: 


0.0000 

0 

0.0000 

0 

17.1400 

1 

17.1500 

14 

1.7600 

20 

1.7800 

50 

14.1600 

18 

14.2400 

20 

64.9700 

10 

65.5500 

10 

-1.0000 

0 

-1.0000 

Plugin status 

0.0000 

0 

0.0000 

Connected OK 

1,143.... 

3 

1,143.... 

ril 

Backfilling AMD... 

- 


10, Group 0, Services, Advertising ♦ IbEmptyTest 




□l 


BACKFILLING ALL SYMBOLS AT ONCE 

To backfill all symbols at once do the following: 

1. Open Realtime Quote window ( by selecting Window->Realtime Quote menu ) 

2. Right click on the Realtime Quote window and choose Add symbol / Add watch list / Type-in symbol to 

add any symbols you want to backfill. 
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ReaKime Quote I 

Ticker 

Open 

High 

Lov,^ 

Last Change 

% Ch... 

Volume 

Trc 
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AA 

12,620.90 

40.54 

12,621... 

41.00 

12,46... 

39.78 
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-1.35% 
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46.22 

45M 


-1.96% 
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BA 
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82.09 

80. 
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-2.76% 
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15. ~ 

All 
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] 
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£ 
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3^ 
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3. Right-click on the plugin Status indicator and select desired Backfill length 
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4. Choose Backfill All RT quote window symbols option from the same menu. 


Since Interactive Brokers severely limits number of backfills that customer may request within given time it is 
advised to use backfill length as short as possible, like 1-day or 5-day and avoid long ranges like 30-days. 


SYMBOLOGY 

Symbol format now uses the symbol mode of TWS, not the underlying mode. The symbol mode in TWS can 
be seen in the 'View->Symbol Mode' menu option in TWS. 

The format is: SYMBOL-EXCHANGE-TYPE 

where 

SYMBOL is the same as the symbol column as displayed in TWS while under symbol mode 
EXCHANGE (optional) is the exchange d in TWS while under symbol mode 
TYPE (optional) is one the following: 
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STK - stocks, FUT - futures, FOP - options on futures, OPT - options, IND - indexes, CASFI -cash (ideai FX) 
Note that for stocks oniy the EXCHANGE and TYPE fieids are optionai. The exchange wiii be set to BEST 
(SMART) and the TYPE wiii be set to STK. 

Piease take speciai care when typing symbois as some of them (futures) have MULTIPLE SPACES in the 
symboi name. You have to type EXACTLY THE SAME number of spaces as provided in the exampies beiow 
(see the dashes beiow symboi name that make it easier to see the number of characters) 


Exampies: 


IB SYMBOL 

— 1 

T3 

CD 

Description 

csco 

Stock 

Cisco Corporation, Nasdaq 

GE 

Stock 

General Electric, NYSE 

VOD-LSE 

Stock 

VODAFONE GROUP, London Stock Exchange 

ESM4-GLOBEX-FUT 

Future 

Emini ES Jun04 futures, Globex 

QQQFJ-CBOE-OPT 

Option 

Jun 04, 36.0 CALL option OOOFJ 

INDU-NYSE-IND 

Index 

Dow Jones Industrials Index 

YM JUN 04--ECBOT-FUT 

Future 

YM Jun 04 future, ECBOT 

(note 3 spaces between symbol and month and 1 

space between month and year) 

QMN5-NYMEX-FUT 

Future 

OM (Crude) June 2005 future contract, NYMEX 

XAUUSD-SMART-CMDTY 

Commodity 

London Gold Spot 

IBUS500-SMART-CFD-USD 

CFD (contract 
for difference) 

IB US500 contract for difference 

EUR.USD-IDEAL-CASH 

EUR.USD-IDEALPRO-CASH 

Cash Forex 

EURUSD currency pair, IDEAL 

EURUSD currency pair, IDEALPRO 


Again: 


ECBOT futures symbois have iength of 21 characters with 3 spaces between contract symboi and month 
name and one space between month and 2 digit year 


Contract 

3 spaces 
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NOTES ON IB API LIMITATIONS: 


1. Backfill Is available for REAL IB accounts only (not on demo) 

2. Open price is NOT provided by IB. For that reason Open field is empty in real time quote window 

3. The data from IB does not include a timestamp on the trades. The current system time is used to timestamp 
each tick. 
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4. IB TWS streaming data are NOT tick-by-tick, but rather 0.2-0.3 second snapshots, read this for 
details: http://www.interactivebrokers.com/cgi-bin/discus/board-auth.pl?file=/2/37364.html 
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How to use AmiBroker with external DDE data source 

Note: the most recent version of this document can be found at: http://www.amibroker.com/dde.html . Please 
check this page for updates. 

WHAT IS DDE 

DDE (Dynamic Data Exchange) is a Windows protocol used to allow applications to exchange data. For 
example, when you change a form in your database program or a data item in a spreadsheet program, they 
can be set up to also change these forms or items anywhere they occur in other programs you may use. DDE 
uses a client/server model in which the application requesting data is considered the client and the application 
providing data is considered the server. 

Thousands of applications use DDE, including Microsoft's Excel, Word, Lotus 1-2-3, and Visual Basic. 

For more information about DDE as communication mechanism in Windows please follow this link: 
http://msdn.microsoft.com/library/en-us/winui/WinUI/WindowsUserlnterface/DataExchange/DynamicDataExchange/Ab( 

DDE FOR TRADERS 

What DDE offers for traders? Basically real time streaming quotes. There is NO BACKFILL via DDE. Many 
real-time data providers and brokerages provide ability to get real-time data by means of DDE. You should 
ask your brokerage/real-time data vendor if they offer DDE link. The DDE plugin now available for AmiBroker 
allows to link to (almost) any DDE source (server) supplying real-time quotes. This makes it attractive option 
for all data sources that do not have dedicated plugin. 

WHEN NOT TO USE DDE PLUGIN 

If you are using eSignal, IQFeed, Quote.com, and any other source that has dedicated plugin - you should 
use this dedicated plugin instead of DDE. This is so because dedicated plugins are ALWAYS better option 
(provide more features plus they are faster) than generic DDE. 

DDE PLUGIN FEATURES SUMMARY 

• user-definable DDE server/topic/item for each field (open, high, low, close, volume, trade size, total 
volume, bid, bid size, ask, ask size, time) 

• supports upto 500 streaming symbols in real time (version 1.1.0) 

• supports all base time intervals: daily, hourly, 15-,5-,1-minute, 15-,5-second, tick 

• NO BACKFILL (due to the fact that most DDE sources do not provide backfill) 

HISTORY 

• 1.2.2 - includes "Time shift" field in the context dialog, stores configuration per-database in dde.config 
file instead of in the registry plus other small improvements 

• 1.2.1 - fixed problem with 'type mismatch' 

• 1.2.0 - by default plugin uses regional settings numeric format now 
and CPU load is decreased 

• 1.1.0- symbol limit increased from 40 to 500 

• 1.0.0 - initial release (BETA) 
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INSTRUCTIONS 

To use DDE data plugin with AmiBroker you need to: 

1. (optional *) Download the latest version DDE plugin from http://www.amibroker.com/bin/DDE.dll and 
copy it to PLUGINS subfolder of AmiBroker directory. 

*Version 1.2.2 of DDE.DLL (Jun 7, 2007) is already included in AmiBroker 5.00 full setup 

2. Enable DDE in the 3rd party software you are using as DDE server (consult data vendor/brokerage 
software documentation for details on how to enable DDE) 

3. Run AmiBroker and create new database with "DDE universal data plugin" as a data source, 
following these steps: 

• Run AmiBroker 

• Choose Flle->New database 

• Type a new folder name (for example: C:\Program Files\AmiBroker\DDE ) and click Create as shown 
in the picture below: 



• Choose DDE universal data plugin from Data source combo and "Enable" from Local data storage 

• Enter 10000 or more into "Number of bars to load" field 

• Now choose Base time interval. Supported Intervals are: EOD, hourly, 15-mlnute, 5-mlnute, 

1-minute. Professional Edition of AmiBroker allows also to select Tick, 5-second, 15-second 
Intervals. 

• Click CONFIGURE button - IMPORTANT: in the "CONFIGURE" dialog you have to setup all fields 
following the description of your data vendor. 

Please check also paragraph below ("CONFIGURING DDE PLUGIN TO WORK WITH YOUR 
VENDOR") for detailed description. ATTENTION: you can not skip this part - without setting up fields 
specifically for your data vendor, the DDE WILL NOT WORK. 
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• Click OK. 

The Plugin status indicator should change from Yellow "WAIT" to Green "OK" within a few seconds. If it does 
not turn to "OK" state it means that either: 

a) server name and/or fields are not set up correctly 
or 

b) DDE server (3rd party application) is not running or is not enabled 

If indicator shows "OK" - then real time qutoes flow into AB. You can check it by displaying Window->Real 
time quote. Note: since there is no backfill you would need to wait for at least 3 bars of data to be collected 
before chart shows up. 

CONFIGURING DDE PLUGIN TO WORK WITH YOUR VENDOR 

Various data vendors come use different DDE connection strings, here a few typical exampels will be shown. 

Most documentation of DDE uses Excel DDE syntax which looks as follows:=SERVER|TOPIC!ITEM 

Server is a name of the DDE server such as WINROS, IQLINK, REUTER, CQGPC, MT, MTLink, etc. 

Topic is the topic of DDE conversation. Depending on Data source topic may be just the ticker symbol (like in 
IQFeed), or the field name (like in winros). 

Item is the item of DDE conversation. Depending on data source it can be field name (like in IQFeed) or ticker 
symbol (like in Winros). 

So DDE connection string in two most common standards look as follows: 
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=WINROS|LAST!MSFT 

=IQLINK|MSFT!LAST 

Now DDE plugin configuration screen looks like this: 



In the UPPER part of the dialog you can see "DDE Server" field. In this field you should enter SERVER part of 
DDE connection string (=SERVER|TOPIC!ITEM) without equation mark and without | character. 

Below you can see 12 text entry boxes where you can define DDE topic and item for each data field your data 
source provides. Here you should enter TOPICIITEM pair of the DDE connection string 
(=SERVER|TOPIC!ITEM) with exiamation mark between DDE topic and DDE item. 

As you can see in the picture above, DDE plugin allow you to use a few special strings, namely: {Ticker}, 
(Field), (FieldSp), (Server), (Id) which are evaluated in run-time for each symbol separately allowing to 
construct dynamic DDE strings (depending on selected ticker for example) required by most data sources: 

• {Ticker} - evaluates to ticker symbol of given security 

• (Field) - evaluates to the corresponding field name (without spaces), i.e. Open, High, Low, Last, 
LastSize, Volume, Ask, AskSize, Bid, BidSize, Time, Req 

• (FieldSp) - similar to (field) but 2-word field names have spaces, namely: "Last Size", "Ask Size", "Bid 
Size" 

• (Server) - evaluates to server name 

• (Id) - evaluates to unique ID (running counter incremented by 1 with each symbol) 

All other texts are carbon-copied, so if you write for example: 
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PREFIXJTicker }_SUFFIX!MYTEXT 

it will evaluate to =SERVER|PREFIX_MSFT_SUFFIX!MYTEXT (provided that current symbol is MSFT) 

Next to field definitions we can see what given definition will evaluate to (in Excel notation). This makes it easy 
to verify if definition is correct. 

Sample evaluation uses always "MSFT" as a {Ticker}, and 34 as (id). 

If your data source does not provide all fields you can make given field empty. Note that for proper operation 
the "Last" price (the price of last trade) is required. If your data source does not provide "last" price (most of 
forex sources don't have "last") you can force DDE plugin to use "Bid" instead. For that you should make 
"Last" field blank and provide appropriate DDE topiclitem pair in "Bid" field. Please also note that Topiclltem 
pairs should evaluate to unique values. 

In the top part of the dialog you can see "Preset" combo-box. 

As of now it allows to pre-set the fields using two generic schemes: 

a) (Field)!{Ticker} - "last price" evaluates to =SERVER|Last!MSFT 

b) (Ticker)!{Field} - "last price" evaluates to =SERVER|MSFT!Last 

In the future "Preset" box will contain more presets for various DDE source that you submit. 

A FEW EXAMPLES 

Connection examples are shown on the web page: http://www.amibroker.com/dde.html 

TEST PLATFORMS 

DDE plugin has been tested and it is known to work properly on Windows XP (32 bit DDE) and Windows 9x 
(16 bit DDE).The following DDE servers are verified by us to work properly: 

• IQLINK (DTN) 

• WINROS (eSignal) 

• MT (Metaquote) 

DDE plugin does NOT work with the following DDE servers: 

• VTSPOT (Visual Trader) - due to improper coding in VisualTrader that causes Microsoft DDEML 
library DdeConnect function to hang on the very first connection attempt 


All other DDE servers not listed above should work properly. Contact support at amibroker.com in case of 
problems. 

HELP US TO HELP THE OTHERS: 

In order to help the others to configure DDE plugin for their data vendor, once you succeded to link with your 
particular vendor please drop as a note with a screenshot of the CONFIGURE dialog and name of the source. 
This will be later included in this document as a reference how to use various data sources. Also working 
setups will be added to "presets" combo for easy one-click configuration. 
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NOTES ON DDE PLUGIN: 

1. There is NO BACKFILL in DDE piugin. You can use however ASCII importer (this inciudes AmiQuote) to 
import historicai data right into the database that you wiii update iater in reai time using DDE piugin. 

2. Change, % change fieids are NOT avaiiabie (yet) 

3. Time and Req fieids are now ignored (this may change in the future) 

4. The current system time is used to timestamp each tick. 

5. When your source does not offer "LAST" price (iike severai Forex sources) you shouid make "Last" fieid 
EMPTY in the configuration diaiog. This wiii teii the piugin to use "BID" field instead. 

6. Plugin status (connected/disconnected) always initially comes up with "Wait" state (Yellow indicator). It 
means that no DDE conversation has been established. If at least ONE DDE conversation starts successfully 
it will turn to "OK" state (green indicator). If DDE server was not running at first attempt to connect, the plugin 
wil NOT attempt to reconnect automatically. Instead you should force reconnection manually (see point 7). 
The indicator may turn to "Disconnected" (red indicator) only in two cases: 

a) you were connected properly but DDE server (3rd party app) has been closed 

b) you selected "shutdown" from plugin status menu 

7. You can reconnect at any time by selecting "reconnect" from plugin status menu. 
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How to work with Real-Time data plugins 


One-time setup 

In order to use AmiBroker with any real-time data source you have to set up the database with 
appropriate data plug-in first. This is required only once at the database creation time. Instructions for 
setting up are available here: eSignal, myTrack, IQFeed, QuoteTracker. 

Check also on-line data sources page at http://www.amibroker.com/quotes.html for new plugins. 
Adding symbols 

Now you can add symbols to your database. To do so please go to Symbol->New menu. In the add symbol 
dialog enter one or more tickers (comma separated) you wish to add to your database. If you want to see the 
chart for newly added symbol just select It from the Symbol tree In the workspace window. Please allow few 
seconds (depending on the speed of your Internet connection) to backfill historical data. 

You may add more tickers that your RT account allows. AmiBroker will automatically swItch/update/refresh 
symbols so the most recently used symbols are active and older ones are automatically removed from Data 
manager. Doing so however may lead to some problems If you exceed your subscription limits too much. So It 
Is advised to use this feature responsibly and not expecting getting 500 symbols while your subscription Is 
limited to only 50. 


Note that the above mechanism does not apply to real time quote window and It can not hold more symbols 
than your subscription limit. 


Showing reai time quote window 


AmiBroker RT features real-time watch window that allows you to watch 
streaming quotes. To show this window choose Window->Reaitime Quote 
menu, (see Image to the right —->) 
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To add symbols to Realtime quote window you either double click on the 
symbol tree or use right mouse button menu Add to Realtime quote option as 
shown In the picture above. 
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Working with reai time quote window 


The RT quote window provides reai-time streaming quotes and some basic fundamentai data. It is fairiy easy 
to operate as shown in the picture beiow: 



You can aiso dispiay context menu by pressing RIGHT mouse button over RT quote window. 
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Realtrne Quote I 
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The context menu allows you to access the following options: 

• Time & Sales 

Opens Time & Sales window that provides Information about every bid, ask and trade streaming from 
the market. 

• Easy Alerts 

Opens Easy Alerts window that provides way to define realtime alerts executed when bld/ask/last and 
other fields hit user-defined levels 

• Add Symbol 

Adds current symbol to Real-Time Ouote list 

• Add watch list... 

Adds entire watch list to real-time quote window 

• Remove Symbol 

Removes highlighted line (symbol) from the Real-Time Ouote list. 

• Remove All 

Removes all symbols from real-time quote list 

• Hide 

Hides Real-Time Ouote list 

Bid/ask trend indicator 
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% Change 
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Version 5.90 adds Bid/Ask trend - a graphical Indicator showing the direction of 10 most recent changes In 
real-time bld/ask prices. The right-most box Is most recent and as new bld/ask quotes arrive they are shifted 
to the left side. Color coding Is as follows: 


• Dark green: bid > previous bid OR ask > previous ask 

• Bright green: bid > previous bid AND ask > previous ask 

• Dark red: bid < previous bid OR ask < previous ask 

• Bright red: bid < previous bid AND ask < previous ask 

• Red / Green box: ask < previous ask AND bid > previous bid 

• Green / Red box: ask > previous ask AND bid < previous bid 
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If bid/ask prices don't change there is no new box. NOTE: This coiumn works oniy if there are reai-time quotes 
streaming (markets are open) 

Working with intraday and daiiy charts 


If your data source supports mixed EOD/Intraday mode (such as eSignal or IQFeed) you can use single 
database for both types of charts. 

However if your data source does not support mixed EOD/Intraday mode and if you want to have long daily 
histories AND intraday charts you should consider running TWO instances of AmiBroker. One for EOD charts 
and second for intraday charting. Both may use the same real-time data source. 

Connection status dispiay 


The data plug-in connection status is displayed in the plugin status display area located in the lower right part 
of the AmiBroker main window as shown in the picture below. When connection status changes AmiBroker 
plays a beep sound and pops up bubble tool tip to inform about status change. 


4l45 TsiOO TfiTS '15:30 
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ffl 

36.80 1^ 
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Piugin status 

Connected and logged on OK 

N" 


t IQFeed 


OK 


The bubble tip provides more detailed information text and disappears automatically after 2 seconds. 

If you want to re-display it just hover your mouse over plugin status display area. 

To enable quick examination of connection status AmiBroker displays color coded information: 

• OK (green light) means that connection is OK and indicates correct operation of the plugin 

• WAIT (yellow light) means that connection is being set-up right now or the plugin is connected only 
partially (to few of many servers). Usually this state is transient and within few seconds the status 
comes back to "OK". 

• ERR (red light) means that connection is broken. It may mean invalid user name/password for your 
subscription, or the fact that some 3rd party component / program required is not running (for example 
if OuoteTracker is not running and you are using OuoteTracker plugin). This state usually requires 
some user intervention such as checking/fixing user/password in File->Database Settings->Configure 
or running required component. When you fix the reason the plugin will automatically attempt to 
reconnect (and if reconnect is successful! then "OK" will be displayed) 

• SHUT (purple light) means that some serious problem occurred and the plugin will not attempt to 
reconnect automatically. In most cases you have to first fix the problem that caused this state and 
then reconnect manually using plugin context menu described below. Alternativelly you can just 
restart AmiBroker. 


Using plugin context menu 
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Real time plugins provide some additional controls via plugin context menu. This context menu is available 
when you click with RIGHT mouse button over plugin status display area. If you do, the menu like this will be 
displayed: 


Reconnect 

, Shiitrinwn 

1 


I ifi-nr 

Force Backfill 

P IQFeed OK 



Please note that various plugins offer various options in this menu, however most plugins provide at least 3 
basic and useful options: 

• Reconnect - this option allows you to reconnect manually. Most RT plugins attempt to reconnect 
automatically, but sometimes manual reconnect is necessary. 

• Shutdown (Disconnect) - this allows to shutdown RT plugin. This is useful when you want to stop 
streaming of quotes. 

• Force backfill - this option causes that plugin re-downloads entire (intraday) history from the server. 
Usually the plugin automatically handles all backfills so you don't need to trigger backfills by hand. If 
the plugin detects that you have some missing quotes from last available bar till current date/time it 
triggers backfills and it is all automatic. But... in at least two cases this option is useful: 

♦ backfilling more bars after settings change (when you enlarge 'number of bars to load' in 
File->Database Settings dialog you have to force backfill for symbols that were backfilled 
previously with smaller number of bars) 

♦ cleaning up bad ticks (when you see a bad tick you may try forcing backfill in hope that data 
vendor has cleaned up its database and you will get fixed data - works well for eSignal that 
really appears to fix bad ticks after they happen) 

Things you should NOT do, or you should do very carefully 

You should note the fact that when you are using data plugin then the plugin controls the quotation database 
(see Understanding database concepts article), therefore you should NOT import quotes from ASCII files (this 
includes AmiQuote) for symbols that are already present in the real-time database. 

If you do, the plugin will eventually overwrite your imports with the real-time data or your database will become 
corrupted (if you import end-of-day data over intraday database). 

So please do not import ASCII (especially EOD data) into real-time intraday database fed by the plugin. 

You may ask: why this is not disabled at all. The answer is that sometimes it is useful and sometimes it will 
work (but these are rare cases). For example it will work if you import INTRADAY data into the intraday 
database fed by QuoteTracker plugin and both the database and imported data have exactly the same bar 
interval. 

It also works if you import the data for symbols that are NOT present in the database. In this case newly 
imported symbols are marked by ASCII importer as "use only local database for this symbol" (See Information 
window for details), so they are EXCLUDED from the real-time update. This is useful if you want to import 
some other data (even not quote data) and access it via Foreign function while using your real-time database. 

So ASCII import is not disabled in real-time database but you have to use it with extreme care and know what 
you are doing. 
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Second thing is using Quote Editor. Aithough data are controiied by the piugin it is in most cases possibie to 
use Quote Editor. However piease note that you wiii be abie to edit oniy 1-minute data or higher intervai, and 
you wiii be abie oniy to edit symbois that are backfiiied compieteiy (there is no running backfiii for the 
particuiar symboi) and you wiii NQT be abie to edit iast three bars. This is so because iast three bars are 
cached in the piugin. So you wiii be abie to edit them oniy when new bars arrive making them 'oider' than iast 
three. 

'WAIT FOR BACKFILL' feature 

The users of eSignai, myTrack and IQFeed reai-time piugins may now check "wait for backfiii" box in the 
Automatic anaiysis window and aii scans, expiorations and backfiiis wiii wait for compietion of backfiii process 
for given symboi. This fiag has no effect on databases that do not use piugins (externai data sources) or use 
end-of-day piugins (iike FastTrack, QP2, TC2000/TCNet, etc). This fiag has aiso no effect when using QT 
piugin due to the fact that QuoteTracker manages backfiiis by itseif and does not provide any controi of 
backfiii process to 3rd party appiications. 

BACKFILLING ALL SYMBOLS AT ONCE 


To backfiii aii symbois at once in the data source that supports "Wait for backfiii" feature (iQFeed, eSignai), 
one can use Anaiysis window. The procedure is as foiiows: 

1. Open Formuia Editor and type a simpie singie-iine ruie iike beiow and choose Tools->Send to Analysis 


Buy = 1; 


2. in the Anaiysis window seiect Apply to: *AII symbols and Range: 1 recent bar 


B @ES# (5-minute) 


Analysis2 x 



: lillScan (5ichExplore t^Backtest » Optimize » Ji - 


: Apply to 

*AII symbols ^ 

7 Range 

1 recent bar(s) » 




and turn on Walt for backfill option. 
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Settings 




Sync chart on select 



Wait for backfill (slow, RT sources only) 



Auto-Repeat (AR) Scan/Explore 



AR interval: 

5min 


v' 

Info Bar 




3. Press Scan button 

The Anaiysis window wiii iterate through aii symbois, requesting backfiii for each symboi and waiting untii the 
data arrive, so at the end of the scan aii symbois wiii be backfiiied. 
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How to use AmiBroker with external data source (Quotes Plus, 
TC2000/TCNet/TC2005, FastTrack, Metastock) 

One of the new features introduced in AmiBroker version 3.90 is the abiiity to read directiy externai databases. 
This is achieved by means of data piug-in DLLs that aiiow to iink AmiBroker database with an externai source. 
Piease note that aithrough you wiii be using externai database, you wiii stiii need an AmiBroker database for 
storing additional information that is not supported by the external source like hand-drawn studies, 
assignments to groups, watch lists, composites and so on. You can find more information on AmiBroker 
database handling here. 

One-time setup 

To use an external data source with AmiBroker you will need to perform a one-time setup described below: 

• Run AmiBroker 

• Choose File->New database 

• Type a new folder name (for example: C:\Program Files\AmiBroker\NewData ) and click Create as 
shown in the picture below: 



• Choose appropriate entry from Data source combo: 

♦ Quotes Plus users select "Quotes Plus plug-in" as a Data Source and "Disable" from 
Local data storage 

♦ TC2000/TCNet users select "TC2000/TCNet plug-in" as a Data Source and "Enable" from 
Local data storage 

♦ TC2000 for Mutual Funds users select "TC2000 Mutual Funds plug-in" as a Data Source 
and "Enable" from Local data storage 

♦ TC2005 users select "TC2000/TCNet plug-in" as a Data Source and "Enable" from Local 
data storage 


How to use AmiBroker with external data source (Quotes Plus, TC2000/TCNet/TC2005, FastTrad^&Jietasto 
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Note: TC2005 users may need to follow these Instructions (click here) If TC2000 plugin does 
not show up. 

♦ Fastirack users select "Fastirack plug-in" as a Data Source and "Disabled" from Local 
data storage 

♦ Metastock users select "Metastock plug-in" as a Data Source and "Disable" from Local 
data storage 

• Click on Configure button to show plugin configuration dialog as shown below 



• Metastock plua-in only (skip this point in case of TC2000, Quotes Plus, FastTrack )\ 

Click on the "Add folder" button to add Metastock database directory as your data source (browse for 
Metastock MASTER file and click OK) as shown below: 



- you can add unlimited number of Metastock directories effectivelly overcoming MS 4096 symbols 
limitation. 
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• Click Retrieve button - this will setup a new database with all symbols and full names. Quotes Plus 
and TC2000 plugins will also setup your sectors/industries names and assignments, as shown below 
(in case of Quotes Plus plugin): 



From now on your AmiBroker reads quotes directly from the external data source. No need to import/update 
quotes anymore. All new quotes will appear automatically without user intervention. 

IMPQRTANT: If there are new symbols added or old symbols deleted to/from the external data source, you 
will need to go to File->Database Settings->Configure and click "RETRIEVE" again to get new symbols. 

Plug in performance notes 

Using AmiBroker native database gives absolutely the best performance (it takes less than 2 milliseconds to 
retrieve 1000 data bars). 

Metastock plugin is also quite fast, as it can retireve 1000 bars in about 6-7 milliseconds (including looking up 
for symbol in 5 different directories). In fact AmiBroker can access Metastock data faster than Metastock itself 

Quotes Plus performance depends on various factors - first access can be much slower (0.1-0.2 sec for 1000 
bars) but subsequent accesses are faster (downto 5 milliseconds). FastTrack plugin is as fast as Quotes Plus 
plugin. 

TC2000 is not as fast, especially if you are using data only on CD. So it is advised to copy your database to 
hard disk for better performance. But still, even when using CD-only data, AmiBroker ca access 1000 bars 
from TC2000 in about 0.25 sec (first access) and 0.015 sec (subsequent accesses). Also it is advised to 
enable "Local data storage" when using TC2000 plugin because it gives tremendous (>10 times) speed-up 
(once you access the TC2000 data, AmiBroker caches them in its own native database for fast retrieval). 

Times are approximate and do not include one-time plug-in initialization process. Measurements where done 
on fairly low-end Celeron 600 based computer with 196KB RAM and 24x CD-RQM 

In-memory caching 

By default AmiBroker holds only 10 the most recently accessed symbols' data in RAM. This takes up about 
320 KB (yes, kilobytes) of memory for 1000 bars per symbol loaded. You can enlarge "In memory cache" 
(Tools->Preferences : "Data" tab) to 100 (approx. 3.2MB additional RAM consumption ) or 1000 (approx. 
32MB additional RAM consumption) or even more to get much better performance for subsequent data 
access (once data are in RAM AmiBroker does not need to ask plugin again and again) 
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How to update US quotes automatically using AmlQuote 

QUICK START 

Run AmiBroker 

Choose Tools->Auto-update quotes (US & Canada) 

HOW IT WORKS 

AmiQuote loads (or retrieves from AmiBroker) a ticker list file (.TLS) which is simple ASCII file with ticker 
symbols, then parses it and generates URLs to the Yahoo! finance site based on ticker name, mode (current 
quotes or historical), country and From/To date. Then, when you start the download process, it requests the 
data from Yahoo and stores downloaded data in the separate .AQD (daily) or .AQH (historical) files for each 
ticker. After download, if AmiBroker is running, AmiQuote will import the quotes into AmiBroker automaticaly. 

USAGE 

Automatic update 

The easiest method to work with AmiQuote and AmiBroker is to use the procedure given in Quick Start 
section of this document. Just run AmiBroker and AmiQuote and choose Tools->Auto-update AmiBroker 
database. This method updates historical quotes from the last date present in AmiBroker upto today. When 
performing automatic update, AmiQuote performs internally 4 steps a) retrieves the ticker list from AmiBroker 
(all symbols loaded currently in AmiBroker); 

b) gets the last quotation date available in AmiBroker; 

c) performs historical download from last date upto today; 

d) instructs AmiBroker to import downloaded files. 

Please note that this procedure works only for US & Canada markets, because Yahoo provides historical 
quotes only for that markets. 

Note that AmiQuote currently supports a new command line parameter: /autoupdate. This option forces 
AmiQuote to perform automatic update procedure without user intervention. 

By default AmiBroker's Tools menu is configured as follows: 

C:\Program Files\AiniBrok:er\AiniQuote\Quote . EXE /autoupdate 

So, you are able to update your US database with a single click on Tools->Auto-update quotes (US & 
Canada) in AmiBroker 

Manual operation 

Automatic mode is nice but there are cases when you have to perform some tasks manually. There is a good 
old document describing that mode of operation at: How to download quotes manually using AmiQuote . 
Everything written in this document remains valid with one exception - now importing to AmiBroker are 
performed automatically if you have Automatic import checkbox marked. 

There are also several cases when you prefer to do things manualy, then please don't forget about some 
useful tools available at your fingertips: 


How to update US quotes automatically using AmiQuote 


139 


AmiBroker 6.00 User's Guide 


Tutorial 


File->Open, File->Save, File->Save As 

These functions enable you to load and save your edited ticker lists for future repeated use. 

Edit->Add tickers 

This function allows you to add the tickers to the list. Just type space separated tickers into 
the field that will show up when you choose this function. 

Edit->Delete tickers 

This function allows you to delete tickers from the list. Just select the items you want to delete 
from the list view (multiple selection possible by holding SHIFT or CTRL key while clicking on 
items), and choose this function. 

Edit->Mark aii, Edit->Unmark aii, Edit->Toggie, Edit->Mark seiection, Edit->Unmark seiection 

These functions allow you to mark the tickers for download. Please note that AmiQuote puts a 
checkmark before ticker name in the list view. ONLY MARKED items will be downloaded. 

This allows you to perform selective downloads/updates. 

View-> Refresh 

Basically AmiQuote handles refreshes by itself when needed. For example if you changed the 
date range, the list will be refreshed before starting download. But there are some cases 
when you may want to refresh the list by yourself. For example if you downloaded and 
imported quotes once and want to do this again you would need to choose this function. The 
Refresh function simply applies all date and type settings to the URLs listed, and MARKS all 
tickers for a new download. 

Tools->lmport into AmiBroker 

This function is useful if you want to import just downloaded quotes into AmiBroker but you 
have Automatic import checkbox cleared. 

Toois->Get tickers from AmiBroker 

This function retrieves all symbols from currently loaded AmiBroker database and fills the 
AmiQuote ticker list with them. 

Toois->Get iast update date 

This function retrieves the date of the most recent quotation of the first symbol present in 
currently loaded AmiBroker database and sets the From date to this date. 

Toois->Settings 

Displays the settings window where you can define the destination directory where all 
downloads are stored. Note that blank destination directory means that downloads will be 
stored in the current working directory (in most cases this is the folder from where current 
.TLS file was loaded). 
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In this window you can aiso change the mode of writing the fiies. By defauit historicai fiies are 
overwritten whiie daiiy fiies get appended. This is recommended setup. Appending daiiy fiies 
simpiy aiiows you to create intra-day historicai fiies when you do the updates daiiy. You may 
change this behaviour for your particuiar purpose. 


Tutorial 
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How to download quotes manually using AmiQuote 

Introduction 

The purpose of this document is to explain how to use AmiQuote and AmiBroker in order to obtain quotes 
from Yahoo finance and Quote.com sites. AmiQuote is a companion program to AmiBroker charting/analysis 
software. The main purpose of AmiQuote is to simplify and automate downloading daily and historical 
quotation data from free Yahoo! Finance (USA, major European exchanges and some other countries), 
Quote.com (USA only) sites, MSN (USA and some European exchanges), Integratir (US stocks). Forex 
(Finam free site) 

Yahoo provides data in "Flistorical" and "Current" modes of AmiQuote. Quote.com provides data in "Intraday" 
mode of AmiQuote. 

Preparing ticker list 

A ticker list is a simple text file which lists line by line the tickers you want to import. The AmiQuote ticker list 
file has .TLS extension. AmiQuote comes with pre-written ticker list for components of main NYSE and 
NASDAQ indices and a number of European indices/markets. Additional ticker lists are available on the 
starter page at: http://www.amibroker.com/starter/. You can use those pre-written ticker lists or you can 
customize them or write your own one. In order to edit existing .TLS file or write completely new one all you 
need is plain text editor such as Notepad or any other plain ASCII editor (not MS Word!). All you have to do is 
to write tickers you want to import line by line (single ticker in single line) and save the file. Please make sure 
that you are saving the file with .TLS extension. Qtherwise AmiQuote will not load this file. 

Please note that Yahoo uses suffixes for non-US stocks. So in order to get quotes for non-US symbol you 
would need to add appropriate suffix to the ticker symbol. The suffixes in alphabetical order are (you can click 
on link to get the symbol list for each exchange) : .AS - Amsterdam, .AX - Australia (ASX), .BC - Barcelona, 
.BE - Berlin, .BQ - Bombay, .BM - Breman, .BR - Brussels, .BA - Buenos Aires, .CL - Calcuta, .CR - Caracas, 
.V - CDNX, .CQ - Copenhagen, .D - Dusseldorf, .F - Frankfurt, .H - Hamburg, .HA - Hanover, .HK - Hong 
Kong, .1 - Ireland, .JK - Jakarta, .KA - Karachi, .KQ - Kosdaq, .KS - KSE, .KL - Kuala Lumpur, .L - London, .LM 

- Lima, .LS - Lisbon, .MA - Madrid, .MX - Mexico, .Ml - Milan, .MU - Munich, .NS - NSE, .NZ - New Zeland, 

.QL - Qslo, .PA - Paris , .SN - Santiago, .SS - Shanghai, .SZ Shenzhen, .ST - Stockholm, .SG - Stutgart, .TW 

- Taiwan, .TA - Tel Aviv, .TQ - Toronto, .VA - Valencia, .VI - Viena, .DE - XETRA, .S - Zurich. 

Please note that also Yahoo and Quote.com use different symbols for indices. The main difference is that 
Yahoo uses ^ (dash) prefix and Quote.com uses $ (dollar) prefix. 

For list of indices provided by Yahoo please click here. 

For list of indices provided by Lycos/Quote.com please click here. Please note that recently 
Lycos/Quote.com stopped delivering free quotes and you need to have Livecharts subcription ($9.95/month) 
in order to use it. For more details see this Knowledge Base article. 

For list of symbols provided by MSN please click here. 
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Downloading data 


In order to download the data please launch AmiQuote. Then please 
click on "Open" button in the toolbar (or choose File->Open menu) as 
shown in picture on the right. ^ 

From the file dialog please choose one .TLS file (for example DIJA.TLS) 
and click Open button. The you will see the main screen of AmiQuote 
filled with the list of tickers loaded, as show in picture below. 


Q AmiQuote 

File View 

H 

) 


i HI 

1 

I 

C^Openl 


I Ticker 


1 Q AmiQuote - Djia.tls 


File View 

Help 




► 

f 


Country: 

USA 

" Quotes: f* Current 

O' Historical 

- -N - 

Ticker 


URL 

Status'^ 

"DJI 


http://quote.yahoo.comyd/quotes.cs... 

Waiting... 

AA 


http://quote.yahoo.eom/d/quotes.cs... 

Waiting... 

GE 


http://quote.yahoo. com/d/quotes, cs... 

Waiting... 

JNJ 


http://quote.yahoo. com/d/quotes, cs... 

Waiting... 

MSFT 


http://quote.yahoo. com/d/quotes, cs... 

Waiting... 

AXP 


http://quote.yahoo. com/d/quotes, cs... 

Waiting... 

GM 


http://quote.yahoo.eom/d/quotes.cs... 

Waiting... 

JPM 


http://quote.yahoo. com/d/quotes, cs... 

Waiting... 

PG 


http://quote.yahoo. com/d/quotes, cs... 

Waiting... 

BA 


http://quote.yahoo. com/d/quotes, cs... 

Waiting... 


Choose appropriate Data Source 


- Yahoo Historical - allows you to download end-of-day histories upto current day (current day data appear 
few hours after session end) 

- Yahoo Current - allows you to download current day quotes (15-min delayed) during the trading session 

- Lycos/Quote.com Intraday - allows you to download intraday and daily historical data (1-min bars and up) - 
for US stocks/futures only. If you have choosen this mode you should also select the bar interval (see the 
limitations described below) - need Livecharts subscription ($9.95/month) 

- MSN Historical - allows you to download end-of-day histories upto current day (current day data appear few 
hours after session end) 

- Forex - allows you to download end-of-day and intraday (registered version) histories for the following 
currency pairs: EURCHF, EURGBP, EURJPY, EURUSD, GBPUSD, USDCHF, USDJPY 


After choosing correct options please click on green arrow (or use File -> Start Download menu). The 
download process will begin. AmiQuote will display progress messages and status information including 
number of completed downloads and number of files left. At anytime you can stop download process with 
"Stop" button (red box). After finishing the download AmiQuote will automatically update the quotes in 
AmiBroker (if only AmiBroker is running in parallel and "automatic import" box in AmiQuote is checked. 

Limitations 

Intraday interval bar data (1-min, 5-min, 15-min, 60-min and 120-min) are available for US securities only. 
Historical data for international exchanges are usually much shorter than for US markets. 


Because intraday bar data are downloaded from Quote.com servers the ticker symbols for indices are 
different than those used by Yahoo. For complete reference please check 
http ://finance. lycos.com/home/misc/symbol_search.asp?options=i 
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Intraday bar data are limited to 500 bars regardless of bar interval. In other words you always get 500 bars 
data, whenever these are 1-min, 5-min, 15-min, 60-min or 120-min data - so by choosing bigger interval you 
get data from more days. This is the limitation imposed by Livecharts server. 


Importing quotes into AmiBroker 

NOTE: This step is no ionger necessary if you are using "automatic import" feature of AmiQuote. The 
expianations are provided oniy for users wanting to import seiectiveiy or re-import fiies downioaded 
in the past. 

First, please launch AmiBroker. From the File menu please select Import From ASCII option. You will see 
the following file dialog: 


-A 


u 


aquotel 1 


[MsJ 


,»1 Adi.aqh 
1*1 Amdaqh 
l^lntc.aqh 
1*1 Nvda.aqh 


Only files of appropriate type are shown 


File name: 

Fi[es^f_^ge; 
Select type 


"Nvda.aqh" "Amd.aqh" "Intc.aqh" "Adi.aqh" 


Open 


AmiQuote Historical (“.aqh) 


Tut 

54.5iS, 



Default ASCII (-.“) 
Yahoo's CSV (“ csvl 


AmiQuote Historical [’'.aqhl 


AmiQuote Daily (“.aqd) 

Metastock ASCII (Mxt) 

Omega SC ASCII F.txt) 

S-Files (s".") 

C-Files jc".’') 

Space separated Ticker.Date.OHLC (“ txt) 
Sharenet DAT T-datl 


Cancel 



' October ' November ' Decembe 


-A/V— — V-V— 


In this picture I marked the most important items for easy identification. Marked with red is type selector 
combo-box {"Files of type"). In order to import AmiQuote files (those with .AQH and .AQD extensions you 
should choose AmiQuote Historical or AmiQuote Daily, or AmiQuote Intraday (.AQI) or AmiQuote MSN 
(.AQM) or AmiQuote eSignalCentral (.AQE) from the combo box (red arrow shows those options). 

After choosing right type you will see only files of appropriate type in the file list (blue arrow shows that). Now 
you can select one or more files from the list. Multiple selection is possible by holding CTRL key depressed 
while selecting the items with a mouse (you can also press SHIFT for choosing a range of files with a single 
click). Now when you are done choosing the files you want to import just click "Open" button. The import 
process will start and you will see progress bar showing the AmiBroker is importing the data. After finishing 
the import AmiBroker will automatically refresh symbol list and you will see updated tickers and charts. If 
anything goes wrong with the import process AmiBroker writes a log file called "import.log" and located in 
AmiBroker's main directory. You can watch this log file if you want to find out what went wrong (since 
import.log is simple text file you can open it with any text editor) 
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Common questions 


Question 


Answer 


How can I edit my 
own ticker list 
(TLS) file? 


You can create or edit TLS using Windows Notepad. When saving a file simply give 
■TLS extension to the file (instead of the default. TXT) 


There are following ready-to-use ticker lists available for download: 


What about 
ready-to-use 
complete ticker 
lists for NYSE, 
NASDAQ, AMEX? 


• DJIA.TLS (30 stocks) 

• DJTA.TLS (20 stocks) 

• DJUA.TLS (15 stocks) 

• NASDAQ100.TLS (100 stocks) 

• NYSE.TLS (2612 stocks) 

• NASDAQ.TLS (4464 stocks) 

• AMEX.TLS (794 stocks) 


Further information 


For further information please consult AmiBroker User's Guide section "Data management - Importing data 
from ASCII file". In case of any further questions, comments and suggestions please contact me at: 
support@amibroker.com 
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Metastock importer window 

IMPORTANT NOTE: Metastock importer should be used ONLY if you want to import MS data to native, local 
AmiBroker database once. If you want AmiBroker to just read Metastock database DIRECTLY without need to 
import new data over and over please set up your database WITH METASTOCK PLUGIN as described in the 
Tutorial. 

NOTE 2: if you setup your database with the MS plugin you should NOT use Metastock importer, because 
there is no point in using it when your data are already fed by the plugin. 



Metastock importer opens AmiBroker to very rich source of historicai data. The importer supports both oid 
Metastock 6.5 and new 7.x (XMASTER) formats. 

Basicaiiy Metastock data consist of: 

• MASTER/EMASTER fiie which hoids generai information about the tickers, stock names, etc. 

• F1 .DAT....FXX.DAT fiies which hoid actuai quotation data 

The MASTER/EMASTER fiie is essential because it holds the references to Fxx.DAT files. Fxx.DAT files store 
only quotations in either 5 field (date/high/low/close/volume), 6 or 7 field 

(date/open/high/low/close/volume/openinterest) format. As you see MASTER/EMASTER and Fxx.DAT files 
are closely connected and you need them all to import the data. 

Usage 

To import Metastock data you should do the following: 

• Choose Metastock import Uom the menu 

• Using the directory requester (Browse...) select the location of data in Metastock format (the directory 
with MASTER/EMASTER and Fxx.DAT files) 

• After choosing proper directory AmiBroker will display the list of available symbols and date ranges. 

By default all available symbol will be marked for importing (checkmark at the beginning of the list). 
Now you can exclude some symbol from the import list by clicking appropriate item in the list 
(checkmark will toggle when you click). 
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• You can decide to which group and watch iist the new symbois are added using Group and Watch 
List combos. 

• After making your seiections push 'Import' button to start the process of importation. 

• During the process you can cancei the operation by ciicking 'Abort' button in the progress window 
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Understanding AmiBroker database concepts 

Background 

A typical Windows application, for example, Paint, works with a SINGLE file. You just open and save that 
single file (.BMP in Paint, or .DOC in MS WORD), and that file holds all the necessary information. 

AmiBroker is a more complex piece of software. It uses huge amounts of data (all quotes from different 
tickers, hand drawn studies, assignments to groups, markets, watch lists, favorites, industries, sectors, etc.), 
so it must manage multiple files. 

It would actually be possible to save all this information in a single file, but it would be (a) huge, and (b) slow 
to update selectively. So AmiBroker uses multiple files for storing all the data. There are a lot of files 
associated with any database. The files for a particular database are stored in a directory (and its 
subdirectories) specific to that database. In AmiBroker documentation, such a directory is referred to either as 
a "database directory" (versions 3.9 or later) or as a "workspace directory" (earlier AmiBroker versions). 

When you install AmiBroker for the first time, a default database directory is created, called 'data', in the 
AmiBroker directory. This database directory contains a sample Dow Jones Industrial Average database. 

In AmiBroker database menu and dialog selections, you are choosing or creating a database 
directory, not an individual file. 

AmiBroker database structure 

A database (or a workspace) is a directory that holds a set of binary files, which are stored in 0-9, a-z,'_' 
subdirectories. Those binary files hold quotes, symbol information, your studies (trend lines, Fibonacci stuff). 
Each symbol's information is stored separately in the file with the name of the ticker symbol located in the 
subdirectory corresponding to the first character of the symbol, so IBM quotation data/studies are stored in the 
'IBM' file located in the T subdirectory. 

The default database for AB is the 'data' directory. It contains DJIA sample data. You may create additional 
databases in other directories via the File->'New database' menu. 

In addition to these subdirectories and files, two additional files are also created by AmiBroker: 
broker.workspace and broker.master. The first is used to store category names and information about 
advancing/declining/unchanged issues. The latter stores the table of all symbols that is used for quick loading 
of the database. These two files are located in the root directory of each database, the 'data' directory, by 
default. 

In almost all cases, you should NOT touch files In an AmiBroker database, as the program manages 
them automatically, and no user Intervention Is required. 

What about the external data? 

AmiBroker 3.9 has the ability to read quotes DIRECTLY from an external data source. Currently, AmiBroker 
can read directly from Quotes Plus (QP2), TC2000 (TC2K) and Metastock (MS) databases. This is achieved 
by means of data plug-ins that AmiBroker uses to read the data from an external data source. When a user 
decides that she/he wants to use an external database - AmiBroker - instead of reading the quotes from its 
own database - just asks the plug-in for quotes for any given symbol. The plug-in reads the external database 
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and feeds the data to AmiBroker. The whole process is shown in the picture below: 



Write qLwtcjtion data 


Data source switch 



Read/write other data 


Read quotation data 


As you can see, data plug-ins provide read-only access to the quotes in the external database. This means 
that your external data sources are never modified by AmiBroker. Changes or additions that you make to data 
and charts (like hand drawn studies, assignments to categories, etc.) are always saved in AmiBroker's own 
database. So AmiBroker still uses its own database (to save changes, as a cache to speed up access, 
and for other tasks), even when using an external data source. 


The Data source switch represented in the graphic above can be set by the user to access various external 
databases. External data sources are selected by going to the File->'Database settings' dialog, shown below: 



You may also choose to store the quotes retrieved from the external source to AmiBroker's own database for 
faster retrieval in subsequent accesses. If you want to do this, you should switch the 'Local data storage' 
setting to 'Enabled'. 
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Note: Similar settings can be found in the Tools->Preferences 'Data' tab, but these are only defaults used 
when creating new databases. File->Database Settings configurations aiways take precedence over 
those done in Preferences - EXCEPT in the foiiowing cases: if you choose the 'Defauit' entry in the 
Data Source drop down iist (shown above), or the 'Defauit' radio button for Locai Data Storage (aiso 
shown above), AmiBroker wiii use your Preferences settings for those items. 
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Understanding categories 

AmiBroker has an ability to assign symbols to different categories allowing you (when properly set up) to 
narrow your analysis searches to the symbols meeting certain selection criteria (thanks to Filter feature 
available in Quick Review and Automatic Analysis windows). The initial set up of categories may be a little bit 
complicated especially when you want to track several thousands symbols. 

Categories show up in Symbols window. First and foremost thing 
to remember is categories do NOT work like folders and 
Workspace window does NOT work like Windows Explorer. 

The difference is fundamental. In the Windows Explorer file 
appears (usually) only once in the given tree leaf. 

In the symbol tree given symbol shows up multiple times because 
it appears in every category leaf to which it belongs to even if this 
is the same symbol and only it exists only as single entity. 

Symbols window is divided into three parts: 

a) search box 

b) category tree 

c) symbol list 

The search box allows to perform full text searches (including 
wildcard matching) against symbol and full name within selected 
category. So for example if you select "Technology" sector and 
type A* (letter 'A' and wildcard character *) the symbol list will 
show all symbols belonging to Technology sector with symbol or 
full name beginning with letter 'A'. Another example would be 
tping *-A0-FX - this will return all forex symbols on eSignal 
database (those ending with -AO-FX substring). 

The category tree (see the picture) shows different kind of 
categories. 

The symbol list (bottom part) shows the list of symbols belonging 
to selected category. The symbol list can be sorted by symbol or 
by full name. To sort just click on the header row of the list. Once 
you choose desired sorting order it will be kept for all subsequent 
category choices and searches. Also the order of columns can be 
changed so Full name column appears as first one. To re-arrange 
column, click on the column header, hold down the moust button 
and drag the column to desired location. Then release mouse 
button. 

Symbols | Layouts Layers | Charts 

Single symbol belongs to MANY categories at the same time. For 
example AAPL (Apple Inc.) will belong to: 

• Stocks group category 

• Nasdaq market category 

• Information sector category 

• Comp-Computer Mfg industry category 


lUOli \ 

This field anfiSvs full-text search* 


<Search> 


within category 


All 

Markets 
NYSE 
Nasdaq 
Composites 
Groups 
Undefined 
Stocks 
Futures 
Options 
Composites 
Other 
Sectors 


All category includes all symbols 
found in the database 


"Markets" group symbols 
^ traded on particular 
exchange 


Different sectors 
group symbols 


Basic Materials belonging to particular 
^ . I ^ , industry 

Capital Goods 

Conglomerates 
Consumer Cydi 
ConsumgHfNon yclical 
Energy 
Financial 

ConsJfner Financial Services 
Insurance (Life) 

Money Center Banks 
Healthcare provides 4-level 

Services 
Techoerogy 




GIC 
Watch Lists 
My pers 
Favourites 
Indexes 


industry group 
categorisation 

Watch lists represent 
user-defined grouping of 
symbols 


The list below shows 
symbols belonging to 
selected category 


Symbol 

S' Full name 

* 

JPM 

■^JP MORGAN C... 


KO 

COCA COLA C... 


MCD 

MCDONALDS... 


Mice 

MMM 

3M COMPANY 
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and may also belong to several watch lists and favorites category. 
All at the same time. That's why one symbol will appear In many 
leaves of the workspace symbol tree. Now If you delete the 
SYMBOL It will of course disappear from ALL categories because 
you have deleted the symbol Itself, not Its assignment to category. 


There are two types of categories: 

1. with mutualy exclusive membership: groups, markets, sectors/industries, GIGS - It means that symbol 
must belong to single group, single market and single sector/industry at a time. You can move the 
symbol from one group/market/sector/Industry to another but you can not remove this assignment - 
you should create "UnassIgned" group/market/sector/Industry Instead and move 'unassIgned' symbols 
there. 

2. with free membership: watch Ilsts/favorltes/Indexes- It means that a symbol may belong to ANY 
number (Including zero) of watch lists (and to favorlte/Index category too). In this case you can 
remove this assignment by Watch Llst->Remove 

Watch lists are covered In detail In the User's Guide: Tutorial: Working with Watch Lists. 

There Is also one special category called "ALL" that shows up In the workspace symbol tree. It simply lists 
ALL symbols present In the database. 

Working with sectors and industries 

Basics - predefined sectors and industries 

Now we will focus on setting up sectors and Industries and assigning the symbols to them. First let me discuss 
some basic Ideas. 

AmiBroker comes with an example Dow Jones Industrials database holding all 30 components of this world's 
most famous market average. They are assigned to predefined sectors and Industries. These sectors and 
Industries are exactly the same as used on Yahoo finance site and here Is a table which shows them all: 


Sector 

industry 


Chemical Manufacturing 


Chemicals - Plastics & Rubber 


Containers & Packaging 

Basic Materials (0) 

Fabricated Plastic & Rubber 

Forestry & Wood Products 


Gold & Silver 


Iron & Steel 


Metal Mining 


MIsc. Fabricated Products 


Non-Metalllc Mining 


Paper & Paper Products 
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Capital Goods (1) 

Aerospace & Defense 


Constr. - Supplies & Fixtures 


Constr. & Agric. Machinery 


Construction - Raw Materials 


Construction Services 


Misc. Capital Goods 


Mobile Flomes & RVs 

Conglomerates (2) 

Conglomerates 


Apparel/Accessories 


Appliance & Tool 


Audio & Video Equipment 


Auto & Truck Manufacturers 

Consumer Cyclical (3) 

Auto & Truck Parts 


Footwear 


Furniture & Fixtures 


Jewelry & Silverware 


Photography 


Recreational Products 


Textiles - Non Apparel 


Tires 


Beverages (Alcoholic) 


Beverages (Non-Alcoholic) 

Consumer/Non-Cyclical (4) 

Crops 

Fish/Livestock 


Food Processing 


Office Supplies 


Personal & Flousehold Prods. 


Tobacco 


Coal 

Energy (5) 

Oil & Gas - Integrated 


Oil & Gas Operations 


Oil Well Services & Equipment 


Consumer Financial Services 


Insurance (Accident & Health) 


Insurance (Life) 

Financial (6) 

Insurance (Miscellaneous) 

Insurance (Prop. & Casualty) 
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Healthcare (7) 

Investment Services 

Misc. Financiai Services 

Money Center Banks 

Regionai Banks 

S&Ls/Savings Banks 

Biotechnoiogy & Drugs 

Heaithcare Faciiities 

Major Drugs 

Medicai Equipment & Suppiies 

Advertising 

Broadcasting & Cabie TV 

Business Services 

Casinos & Gaming 

Communications Services 

Hoteis & Motels 

Motion Pictures 

Personal Services 

Services (8) 

Printing & Publishing 

Printing Services 

Real Estate Operations 

Recreational Activities 

Rental & Leasing 

Restaurants 

Retail (Apparel) 

Retail (Catalog & Mail Order) 

Retail (Department & Discount) 

Retail (Drugs) 

Retail (Grocery) 

Retail (Home Improvement) 

Retail (Specialty) 

Retail (Technology) 

Schools 

Security Systems & Services 

Waste Management Services 

Communications Equipment 

Computer Hardware 

Computer Networks 


i^\^Si^^9l)^tffhectors and industries 
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Computer Peripherals 


Computer Services 


Computer Storage Devices 


Electronic Instruments & Controls 


Office Equipment 


Scientific & Technical Instr. 


Semiconductors 


Software & Programming 


Air Courier 


Airline 

Transportation (10) 

Misc. Transportation 


Railroads 


Trucking 


Water Transportation 


Electric Utilities 

Utilities (11) 

Natural Gas Utilities 


Water Utilities 


It is important to understand the difference between a sector and an industry: industries "beiong" to sectors, 
for exampie: "Air Courier", "Airiine", "Raiiroads", "Trucking" industries beiong to "Transportation" sector. So if a 
symboi is assigned to given industry, it is "automaticaiiy" assigned aiso to the corresponding sector. 

In the example DJIA database each stock is assigned to specific industry, for example GM (General Motors) 
is assigned to "Auto & Truck Manufacturers" industry, and this implicates that GM belongs to 
"Consumer/Cyclical" sector. 

AmiBroker can handle up to 32 sectors and up to 256 industries. 

How to assign symbol to the industry? 

You can change the industry to which given symbol is assigned by using Window->lnformation dialog 
(Industry combo box) 


Working with sectors and industries 


155 



AmiBroker 6.00 User's Guide 


Tutorial 



or using Symbol->Organize Assignments. 



The first method is fine if you want to change singie symbol settings. The latter is better if you want to move 
multiple symbols from one category to another. 
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How to define your own sectors and industries 

Please go to Symdo/->Cafegor/es dialog, the last two tabs are "Sectors" and "Industries". First, switch to the 
"Sectors" tab and you will see the list of 32 sector names. You can now select the sector by clicking once on 
its name and edit the sector name by pressing ENTER or clicking "Edit name" button. Hit ENTER again to 
accept the name change. 



After you renamed the sectors you can switch to the "Industries" tab. Similarly to the previous tab you can 
select the industry in the list and edit its name in the same manner. Here you can also assign the industry to 
the sector using "Sector" combo. Just select the sector to which you want to assign currently selected 
industry. 
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Where sector and industry information is stored? 

Generally speaking this Information Is stored In AmiBroker database. The sector and Industry names and 
settings are stored In the broker.workspace file (In the workspace folder), symbol data files hold only the 
Information about the assignment of the symbol to given Industry (IndustrylD). 

When you create a new workspace (a database) AmiBroker sets up your Industries and sectors according to 
the templates stored In the "broker.sectors" and "broker.Industries" files. These are simple text files that could 
be edited with plain text editor (such as Notepad). These files could be also used for quick, automatic setup of 
the sectors and Industries. AmiBroker comes with predefined broker.sectors and broker.Industries that follow 
described above convention (see the table). You can rewrite broker.sectors and broker.Industries files to 
define your own default scheme. So, "broker.sectors" and "broker.Industries" files are used as a template 
when creating new workspace. Once workspace Is created these files are not taken Into consideration. In this 
way you may have different categories In each workspace. If you want AmiBroker to load them Into already 
existing workspace please delete broker.workspace file before opening the workspace. If you then open the 
workspace AmiBroker will read broker.sectors and broker.Industries. 

The layout of broker.sectors file Is very simple: It Is plain text file holding sector names written line by line as 
shown below: 

Basic Materials 

Capital Goods 

Conglomerates 

Consumer Cyclical 

Consumer/Non-Cyclical 

Energy 

Financial 

Healthcare 

Services 

Technology 

Transportation 

Utilities 

The layout of broker.Industries Is similar, but In addition to Industry names there Is a number at the beginning 
of each line: 

8 Advertising 
1 Aerospace & Defense 
10 Air Courier 
10 Airline 

3 Apparel/Accessories 
3 Appliance & Tool 
3 Audio & Video Equipment 
3 Auto & Truck Manufacturers 

3 Auto & Truck Parts 

4 Beverages (Alcoholic) 

4 Beverages (Non-Alcoholic) 

7 Biotechnology & Drugs 

8 Broadcasting & Cable TV 
8 Business Services 

8 Casinos & Gaming 
0 Chemical Manufacturing 
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0 Chemicals - Plastics & Rubber 
5 Coal 

9 Communications Equipment 

The numbers at front of industry names are "Sector IDs". Those numbers decide to which sector given 
industry belongs to. Because several industries may belong to one sector - you may need to put the same 
number for sector Id. Sector IDs are zero based, which means that 0 refers to the first line (sector name) of 
"broker.sectors" file, while 7 refers to the eighth line of this file. In the example above: "Advertising" industry 
belongs to "Services" sector, while "Aerospace & Defence" industry belongs to "Capital Goods" sector. 

If you don't want to setup detailed industry information and want assign symbols only to sectors you can 
define one-to-one relationship between first 32 industries so they will be equivalent to sectors. Using the 
broker.sectors as show earlier in this article 1-1 broker.industries file would look like: 

0 Basic Materials 

1 Capital Goods 

2 Conglomerates 

3 Consumer Cyclical 

4 Consumer/Non-Cyclical 

5 Energy 

6 Financial 

7 Healthcare 

8 Services 

9 Technology 

10 Transportation 

11 Utilities 

Note that this file is essentially the same as broker.sectors with the only difference that we have consecutive 
numbers prepended to each line. Using this kind of setup setting the industry will be equivalent to setting the 
sector. 

Making it automatic 

As described above symbol and industries names and relationship can be easily set up quickly using 
"broker.sectors" and "broker.industries" files. It will save some work needed otherwise to enter this information 

in Symbol->Categories window. 

Unfortunately a lot more work is needed to assign all symbols to the industries even using 

Symbol->Organize Assignments dialog. 

Fortunatelly there is a way to setup and update the database automatically. 

In pre-5.60 version it still required scripting and lots of work (see 4th issue of AmiBroker Tips newsletter) but 
version 5.60 brings completely new ways to setup the database automatically. 

The improved ASCII importer in v5.60 allows to import symbols, sectors and industry names and build 
complete database in just one step. 

Let us say that we have CSV file that looks as follows: 

"DDD","3D Systems Corporation","Technology","Computer Software: Prepackaged Software" 

"MMM","3M Company","Health Care","Medical/Dental Instruments" 

"SVN","7 Days Group Holdings Limited","Consumer Services","Hotels/Resorts" 
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"AHC","A.H. Belo Corporation","Consumer Services","Newspapers/Magazines" 

"AIR","AAR Corp.","Capitai Goods","Aerospace" 

"AAN","Aaron's, Inc.","Technoiogy","Diversified Commerciai Services" 

Now we can import it into AmiBroker and automatically setup all sectors and industries using this format 
definition 

$FORMAT Ticker, FullName,SectorName,lndustryName 
SSEPARATOR , 

SAUTOADD 1 
SNOQUOTES 1 
SOVERWRITE 1 
SCLEANSECTORS 1 
SSORTSECTORS 1 

The last two commands ($CLEANSECTORS and $SORTSECTORS) instruct AmiBroker to clean (wipe) 
existing sector/industry names before importing and sort newly imported sectors after importing so they 
appear alphabetically 

AmiBroker will read such ASCII file one-by one, then it will check whenever given sector name/industry name 
already exists, if not - it will create new sector/industry. Then it will assign given symbol to specified 
sector/industry. 

The result will be a database with new sector/industry structure being set up and symbols assigned to proper 
sectors and industries. 

Described functionality is used to implement Tools->Update US symbol list and categories tool. 

One-click "Update US symbol list and categories" 

Automatic setup and update of US stock database is available from Tools->Update US symbol list and 
categories menu. This is implemented using new #import command and new ASCII importer commands 
described above. 

The command downloads symbol, sector and industry list from amibroker.com web site and create or update 
current database with stocks listed on NYSE, Nasdaq and AMEX. It also creates sector and industry structure 
and assigns stocks to proper industries. 

CAVEAT: Be aware that using this tool will WIPE (delete) any existing sectors/industries and replace them 
with the ones imported automatically. 

Note about GICS 

GICS stands for Global Industry Classification Standard 
(http://en.wikipedia.org/wiki/Global_lndustry_Classification_Standard). 

AmiBroker allows also GICS 4-level classification system, but demo database does not have symbols 
classified according to that standard. You can find GICS classification codes in GICS.txt file inside AmiBroker 
folder. 

Note about ICB 
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ICB stands for Industry Classification Benchmark 
(http://en.wikipedia.org/wiki/lndustry_Classification_Benchmark). 

AmiBroker allows also ICB 4-level classification system, but demo database does not have symbols classified 
according to that standard. You can find ICB classification codes in ICB.txt file inside AmiBroker folder. 


Working with sectors and industries 


161 


AmiBroker 6.00 User's Guide 


Tutorial 


Working with watch lists 

AmiBroker 5.00 uses now new watch list system. Watch lists differ from other kinds of categories (as groups, 
markets, industries, sectors) in that, that you can assign single symbol to more than one watch list. 

You can use UNLIMITED number of watch lists with their names definable in Symbol->Categories mndovj. 
The members of each watch list is shown in the symbol tree under "Watch lists" leaf. 

Watch lists are now stored as text files inside "Watchlists" folder inside database. The folder contains of any 
number of .TLS files with watch lists themselves and index.txt that defines the order of watch lists. You can 
add your own .tis file (one symbol per line) and AmiBroker will update index.txt automatically (adding any new 
watch lists at the end)The .TLS files can also be open in AmiQuote. 

Watch lists remember the order in which symbols were added, so for example if you sort AA result list in some 
order and then you"add symbols to watch list" the order will be kept in the watch list. 

Adding / removing watch lists 

You can now Add/Delete watch lists using Symbol->Watch List->New Watchlist and Symbol->Watch 

List->Delete Watch list menu or from watch list context menu. Note that if you have done any customization 
to the menu, you may need to go to Tools->Customize, select "Menu Bar" and press "Reset" button for this 
new menu items to appear. 


Symbol ; Analysis 

Tools Window Help 

^ New... 


Po - - * ^ 151 

Delete 

f 

1 


I* Split... 

Merge... 


14 23:59:00 Open 2.959, Hi 2.959, Lo 2 

M Find 

F3 



Q Information... 
a Quote Editor... 
Favourites 
Watch list 
Real Time Quote 
Categories... 

Qrganize assignments... 
Calculate composites... 


JF X 


Sep 


Nov 


PLNA0-FX-TSF(Close.15 



Add selected symbol... 
Remove selected symbol... 
lype-in symbols.,. 
Import... 

Export... 

Erase (make empty)... 

Sort alphabetically... 

Hide empty watchlists 
New watchlist... 

Delete watchlist... 



Adding tickers to watch lists 

You can easily add a ticker to the watch list by simply clicking with a right mouse button over the item in the 
symbol tree and choosing Watch List->Add selected symbol option: 
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♦ JET 


Add to favourites 


♦ 

♦ 

♦ 

♦ 

♦ 

♦ 

♦ 

♦ 

♦ 

♦ 

♦ 

♦ 

♦ 

♦ 

♦ 

♦ 


AKA 

ALT 

AMy- 

AM( 

AMlj 

am: I 

APC 

AT\' 

BBB-r 


Erase favourlties 


Web Research 


Watch list 




Delete 


BEAS (BEA SYS INC” 
BHB (BIOGEN IDEC ) 
BMET (BIOMET INC 
BRCM (BROADCOM 
CDNS (CADENCE DE 
CDWC (C D W CORI 
CELG (CELGENE COI 




P* 


Add selected symbol 
Remove selected symbol 
Type-in symbols... 
Import... 

Export... 

Erase (make empty) 

Sort alphabetically 

Hide Empty watchlists 

New watchlist... 

Delete watchlist 


After choosing this option a watch iist seiector window wiii appear: 



Here you shouid seiect the iist you want to add the symboi to. Note that you can add one symboi to muitipie 
iists at once, by hoiding CTRL key whiie ciicking on the iist items. After ciicking OK seiected symboi (MSFT) 
appears in the watch iist of your choice: 


# WMT 

# XOM 
ij l_J Markets 
ij CJ Groups 
ij C_l Sectors 

Watch lists 


'i 


R I n [My first list (renamed in c ategories)! 


# MSFT 

♦ PG 

I T Favourites , 


lL 




n Stock seleoiorr 



'Hay 
VSheet ifi 


You can also type-in symbols directly into the watch list using Symbol->Watch list->Type-in option. 
Symbols should be comma-separated. You can also right click over the watch list name in the workspace tree 
to type in symbols directly into the watch list. 


Sorting tickers in a watch list 
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You can now alphabetically sort the symbols in the watch list - click on the watch list with RIGHT mouse 
button and select "Sort Alphabetically" 

Removing tickers from watch lists 

Removing symbols from the watch list is as easy as adding them. Just click on the list member with a right 
mouse button and select Remove from watch list(s). Then similar list selector window will appear showing 
only those lists that currently selected symbol belongs to. You can now select one or more lists and the 
symbol will be removed from the list(s). 

Erasing watch lists 

Sometimes you may want to clear (or erase) the whole watch list. Then just select Symbol->Watch 
list->Erase (empty) option. In the watch list selector window mark the list(s) you want to clear and click OK. 
This way selected watch list(s) become empty. 

Hiding/Unhiding empty watch lists 

By default empty watch lists are shown in the symbol tree but you can hide them by right-click on watch list in 
the symbol tree and select "Hide Empty Watchlists" menu. To un-hide, select this option again. 

Using watch lists in Automatic analysis window 


AmiBroker gives you a very easy way to store the results of scanning, backtesting and exploration into a 
watch list with a single mouse click - just run your favourite AFL formula over the whole database and click on 
the results list with a right mouse button to see the following menu: 
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When you choose Add all/selected results to watch list a watch list selector will appear where you select to 
which list symbols should be added, then after clicking OK all symbols filtered by your trading rules will 
automatically appear in the watch list of your choice. 

You can also use option Replace watch list with the results/selected results 

This new option empties the watch list before adding results. The order of symbols in the result list is 
preserved in the watch list. 


How to import/export watch list from/to file 


IMPORT WATCH LIST FROM FILE 

1. Choose Symbol->Watch List->lmport menu, or right click over watch list in the tree and choose Import. 


Symbol Analysis Tools Window Help 


a 

m 

New... 

Delete 

Split... 

Merge... 

Find F3 

Information... 

Quote Editor... 

Favourites ► 

▼ _ AT ! 


:.36. Hi 515.4. Lo 510.58, Close 511.4 ( 

Watch list K ► 


Add selected symbol... 


Real Time Quot^ ► 


Remove selected symbol... 


Categories... 


Type-in symbols... 


Organize assignments... 


Import... 


Calculate composites... 


Export... 



Sort alphabetically... 
Hide empty watchlists 
New watch list... 
Delete watchlist... 


2. Choose destination watch list 

3. In the file dialog that will appear pick .TLS, .LST, .TXT or .CSV file 

.TLS, .CSV, .TXT files should have one ticker symbol per line and no other fields. 

.LST files are Quotes-Plus standard, comma separated list files that have the ticker symbol in the first column 
and some additional data in remaining columns. AmiBroker reads just first column and ignores rest. 

4. Click OK. 


EXPORT WATCHLIST TO FILE 
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1. Choose Symbol->Watch List->Export menu. 

or right click over watch list in the tree and choose Export. 

2. Choose source watch list and switch to "External data source" 

3. In the file dialog choose the file to export to. Generated file will be simple ASCII file witch one ticker symbol 
per line. 


How to import/export watch list from/to external database 

ATTENTION: It works ONLY if you have "Data source" set to "Fast Track" plugin in File->Database Settings 
(and if you have FastTrack database installed of course). 

IMPORT FAMILY FROM FASTTRACK 


1. Choose Symbol->Watch List->lmport menu, or right click over watch list in the tree and choose Import. 
Symbol I Analysis look Window Help 


a 

m 

New... 

Delete 

Split... 

Merge... 

Find F3 

Information... 

Quote Editor... 

Favourites ► 



;.36. Hi 515.4. Lo 510.58, Close 511.4 ( 

Watch list K ► 


Add selected symbol... 


Real Time Quot;^ ► 


Remove selected symbol... 


Categories... 


Type-in symbols... 


Organize assignments... 


Import... 


Calculate composites... 


Export... 



Sort alphabetically... 
Hide empty watchlists 
New watch list... 
Delete watchlist... 


2. Choose destination watch list and switch to "External data source" 
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3. In the dialog that will appear unfold one category and select the family you want to import symbols from: 


FastTrack Family selector 


S Mutual Fund Category 
S Stock Category 

97DJ-BK ■ DJ US Banks Index B8 components on 01/01/97[lndex) 


97DJ-BM ■ DJ US Basic Materials Index 85 components on 01/01/97(lndex) 


97DJ-EN ■ DJ US Energy Index 74 components on 01701797(1 ndex) 

97DJ-GI - DJ US General Industrial Servic 7G components on 01701797(1ndex 
97DJ-IE ■ DJ US Industrial Equipment Inde 90 components on 01701797(1 nde; 
97DJ IR ■ DJ US Insurance Index 48 components on 01701797(1ndex) 

97DJ NC - DJ US Consumer I4onCyclical Inde 89 components on 01701797(1r 
97DJ-0G ■ DJ US Oil & Gas Index 73 components on 01701797(1 ndex) 

97DJ-PH ■ DJ US Pharmaceuticals & Biotech 62 components on 01701797(1 m 
97DJ-PT • DJ US Retailers Index 76 components on 01701797(1 ndex) 

97DJ-SF • DJ US Specialty Finance Index 54 components on 01701797(1 ndex 
97DJ-UT - DJ US Utility Index 58 components on 01701797(lndex) 

ALL • All Funds + Stocks + most Indices in FT Databases on 03-04-2002 
ALL'S - All Stocks and Closed End Funds in FT Databases on 03-04'2002 
BTK'X • NASDAQ BioTech Index on 5722701 (Index) 

J ^ 


n I 1 c n I 1R 11 HU ,. I . r 1 n /onni ri«.1 


2<l 


OK 


_ Cancel 


4. Click OK. 


EXPORT WATCHLIST TO FASTTRACK FAMILY 

1. Choose Symbol->Watch List->Export menu. 

or right click over watch list in the tree and choose Export. 

2. Choose source watch list and switch to "External data source" 
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3. Now either TYPE IN the new personal family name in "New user family" (and the description in the file next 
on the right side) OR choose existing personal family from the list. 
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Understanding how AFL works 

Introduction 

One of most important aspects of AFL is that it is an array processing ianguage. It operates on arrays (or 
rows/vectors) of data. This way of operation is quite simiiar to the way how popuiar spreadsheets work (iike 
Microsoft Excei). Anyone famiiiar with MS Excei shouid have no troubie quickiy picking up AFL. - In fact all the 
examples in this article were all created using MS Excel. 

What is an Array? 

An array is simply a list (or row) of values. In some books it may be referred to as a vector. Each numbered 
row of values in the example represents an individual array. Amibroker has stored in its database 6 arrays for 
each symbol. One for opening price, one for the low price, one for the high price, one for the closing price and 
one for volume (see the rows labelled 1-5 below) and one for open interest. These can be referenced in AFL 
as open, low, high, close, volume, openint or o, I, h, c, v, oi. 



Bar 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

1 

Open 

1,23 

1,24 

1,21 

1,26 

1,24 

1,29 

1,33 

1,32 

1,35 

1,37 


Fig 1. Open price array 

Any other array is calculated from these 6 arrays using formulae built into AFL. These arrays are not stored in 
the database but calculated where necessary. 

Each individual value in an array has a date associated with it. If you have the tool tip option turned on 
(Preferences -> Miscellaneous Tab - > Price data tool tips), when you move your cursor over candle on a daily 
candle chart, a small yellow rectangle appears. AFL then looks up the open, low, high, close, volume values in 
the appropriate array and displays them inside the tool tip. 

Processing arrays - why is AFL so fast? 

Lets see how the following statement is processed: 

MyVariable = ( High -i- Low )/2; 

When AFL is evaluating statement like this ( High -i- Low )/2 it does not need to re-interpret this code for each 
bar. Instead it takes the High ARRAY and Low ARRAY and adds corresponding array elements in single 
stage. In other words -i- operator (and other operators too) work on arrays at once and it is executed at full 
compiled-code speed, then the resulting array (each element of it) is divided by 2 also in single stage. 

Let's look into the details - see fig 2.. When AFL engine looks at the ( High -i- Low )/2 it first takes High (1) and 
Low (2) arrays and produces (in single compiled step) the temporary array (3). Then it creates the final array 
(4) by dividing each element of temporary array by two. This result is assigned to myVariable 



Bar 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

1 

High (built-in array) 

1,24 

1,27 

1,25 

1,29 

1,25 

1,29 

1,35 

1,35 

1,37 

1,29 

2 

Low (built-in array) 

1,20 

1,21 

1,19 

1,20 

1,21 

1,24 

1,30 

1,28 

1,31 

1,27 

3 

High+Low (temporary array created during 
evaluation) 

2,44 

2,48 

2,44 

2,49 

2,46 

2,53 

2,65 

2,63 

2,68 

2,46 
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4 ( High+Low) /2 (gets assigned to MyVariable) 

1,22 

1,24 

1,22 

1,245 

1,23 

1,265 

1,325 

1,315 

1,34 

1,23 

Fig 2. AFL steps when processing ( High + Low ) / 

2 


Moving averages, conditional statements 

Let us now consider the following code: 

Condi = Close > MA ( Close, 3 ); 

Cond2 = Volume > Ref( Volume, -1 ); 

Buy = Condi AND Cond2; 

Sell = High > 1.30; 

This code generates a buy signal when todays close is higher than 3 day moving average of close AND 
todays volume is higher than yesterday's volume. It also generates a sell signal when today's high is higher 
than 1.30. 

If in your AFL code you need to see if the closing price is greater than say a 3 day simple moving average 
AFL will first run through the close array creating a new array called MA(close,3) for the symbol being 
analysed. Each cell in the new array can then be compared one for one in the close array. In the example an 
array called Condi is created this way. For each cell where the closing price is greater than the corresponding 
cell value in MA(close,3) the cell value for new array 'Condi' is set to '1'. If the closing price is not greater than 
the corresponding price in the close array the value in 'Condi' is set to 'O'. 

AFL can also look forwards or backwards a number of cells in an array using the Ref function (see row 6 
where temporary array is created holding previous day volume) 

In row 9 a new array called Cond2 has been created by comparing the value of each cell in the volume array 
with its previous cell setting the Cond2 cell value to '1' if true and 'O' if false. 

Row 10 shows an array called 'Buy' created by comparing the cell values in Condi with the cell values in 
Cond2. If the cell in Condi has a 'T AND so does the corresponding cell in Cond2 then a 'T is placed in the 
'Buy' array cell. 

Row 11 shows an array called 'Sell' created whenever the cell value in the close array is greater than $1.30. 



Day 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

1 

Open 

1,23 

1,24 

1,21 

1,26 

1,24 

1,29 

1,33 

1,32 

1,35 

1,37 

2 

High 

1,24 

1,27 

1,25 

1,29 

1,25 

1,29 

1,35 

1,35 

1,37 

1,29 

3 

Low 

1,20 

1,21 

1,19 

1,20 

1,21 

1,24 

1,30 

1,28 

1,31 

1,27 

4 

Close 

1,23 

1,26 

1,24 

1,28 

1,25 

1,25 

1,31 

1,30 

1,32 

1,28 

5 

Volume 

8310 

3021 

5325 

2834 

1432 

5666 

7847 

555 

6749 

3456 

6 

Ref( Volume, -1 ) (temporary array 
created during eval) 

Null 

8310 

3021 

5325 

2834 

1432 

5666 

7847 

555 

6749 

7 

MA( Close, 3 ) (temporary array 
created during eval) 

Null 

Null 

1,243 

1,260 

1,257 

1,260 

1,270 

1,287 

1,310 

1,300 

8 

Condi = Close < MA(close,3) (gives 

1 (or true) if condition met, zero 

Null 

Null 

1 

0 

1 

1 

0 

0 

0 

1 


otherwise) 
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9 

Cond2 = Volume > Ref(volume,-1) 

Null 

0 

1 

0 

0 

1 

1 

0 

1 

0 

10 

Buy = Condi AND Cond2 

Null 

Null 

1 

0 

0 

1 

0 

0 

0 

0 

11 

Sell = High > 1.30 

0 

0 

0 

0 

0 

0 

1 

1 

1 

0 


Obviously Buy and Sell are special arrays whose results can be displayed in the Analyser window or on 
screen using a red or green value as needed. 


Getting little bit more complex 

The examples above were very simple. Now I will just explain 3 things that seem to generate some confusion 
among the users: 

• referencing selected values (SelectedValue, BeginValue, EndValue, LastValue) 

• IIP function 

• AMA function 

As written in the Tutorial: Basic charting guide you can select any quote from the chart and you can mark 
From-To range. The bar selected by verticall line is called "selected" bar while start and end bars of the range 
are called "begin" and "end" bars. AFL has special functions that allow to reference value of the array at 
selected, begin and end bar respectively. These functions are called SelectedValue, BeginValue and 
EndValue. There is one more function called LastValue that allows to get the value of the array at the very last 
bar. These four functions take the array element at given bar and return SINGLE NUMBER representing the 
value of the array at given point. This allows to calculate some statistics regarding selected points. For 
example: 

EndValue( Close ) - BeginValue( Close ) 

Will give you dollar change between close prices in selected from-to range. 

When number retrieved by any of these functions is compared to an array or any other arithmetic operation 
involving number and the array is performed it works like the number spanned all array elements. This is 
illustrated in the table below (rows 2, 6, 7). Green color marks "begin" bar and red color marks "end" bar. 
Selected bar is marked with blue. 



Day 

1 

2 

3 

4 

5 

6 

7 


9 

10 

1 

Open 

1,23 

1,24 

1,21 

1,26 

1,24 

1,29 

1,33 

1,32 

1,35 

1,37 

2 

BeglnValue( Open) 

1,24 

1,24 

1,24 

1,24 

1,24 

1,24 

1,24 

1,24 

1,24 

1,24 

3 

EndValue( Open) 

1,32 

1,32 

1,32 

1,32 

1,32 

1,32 

1,32 

1,32 

1,32 

1,32 

4 

SelectedValue( Open) 

1,21 

1,21 

1,21 

1,21 

1,21 

1,21 

1,21 

1,21 

1,21 

1,21 

5 

LastValue( Open) 

1,37 

1,37 

1,37 

1,37 

1,37 

1,37 

1,37 

1,37 

1,37 

1,37 

6 

Close 

1,22 

1,26 

1,23 

1,28 

1,25 

1,25 

1,31 

1,30 

1,32 

1,28 

7 

Close <= BeglnValue( 
Open) 

1 

0 

1 

0 

0 

0 

0 

0 

0 

0 

8 

result = IIF( Close <= 
BeglnValue( Open), 
Close, Open); 

1,22 

1,24 

1,23 

1,26 

1,24 

1,29 

1,33 

1,32 

1,35 

1,37 

9 

Period 

2 

3 

4 

2 

3 

5 

2 

3 

4 

2 

10 

Factor = 2/(Period+1) 

0,667 

0,500 

0,400 

0,667 

0,500 

0,333 

0,667 

0,500 

0,400 

0,667 
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11 

1 - Factor 

0,333 

0,500 

0,600 

0,333 

0,500 

0,667 

0,333 

0,500 

0,600 

0,333 

12 

AMA( Close, Factor) 

0,8125 

1,0363 

1,1138 

1,2234 

1,2367 

1,2399 

1,2853 

1,2927 

1,3036 

1,2866 


Now the IIF(condition, truepart, falsepart) function. It works that it returns the vaiue of second {truepart) or 
third (falsepart) argument depending on condition. As you can see in the table above in row 8 the values 


come from Close array (truepart) for bars when condition is true (1) and come from Open array (talsepart) for 
the remaining bars. In that case the array returned by IIF function consists of some values from Close and 
some values from Open array. Note that both truepart and talsepart are arrays and they are evaluated 
regardless of the condition (so this is not a regular IF-THEN-ELSE statement but function that returns array) 

The AMA( array, factor) function seems to cause the most problems with understanding it. But in fact it is very 
simple. It works in recursive way. It means that it uses its previous value for the calculation of current value. It 
processes array bar by bar, with each step it multiplies given cell of first argument (array) by given cell of 
second argument (factor) and adds it to the previous value of AMA multiplied by (1-factor). Lets consider 
column 3. The value of AMA in the column 3 is given by multipling close price from column 3 (1,23) by factor 
(0,4). Than we add the previous value of AMA (1,0363) multiplied by (1 -factor = 0,6). The result (rounded to 4 
places) is 1,23 * 0,4 -r 1,0363 * 0,6 = 1,1138. 

If you look at the figures in the row 12 you may notice that these values look like a moving average of close. 
And that's true. We actually presented how to calculate variable-period exponential moving average using 
AMA function. 

New looping 

With version 4.40 AmiBroker brings ability to iterate through quotes using for and while loops and adds it-else 
flow control statement. These enhancements make it possible to work BOTH ways: either use ARRAY 
processing (described above) for speed and simplicity or use LOOPS for doing complex things. As an 
example how to implement variable period exponential averaging (described above) using looping see the 
following code: 

Period = ... some calculation 


vaexp[ 0 ] = Closet 0 ]; // initialize first value 


for( i = 1; i < BarCount; i++ ) 

{ 

// calculate the value of smoothing factor 
Factor = 2/(Period[ 1 ] + 1 ); 


// calculate the value of 
// using this bar close ( 
1 ] ) 


i-th element of array 

close[ 1 ] ) and previous average value 


vaexp[ 


vaexp[ 1 

} 


Factor * Close[ 1 ] + ( 1 


Factor ) * vaexp[ 1-1 ]; 


As you can see the code is longer but on the other hand it is very similar to any other programming language 
as C/Pascal/Basic. So people with some experience with programming may find it easier to grasp. 

If you are beginner I suggest to learn array processing first before digging into more complex looping stuff. 

If you're having trouble coding AFL I suggest you generate the arrays in the example in Excel for yourself. If 
that's a problem get some help from a friend - especially if that friend is an accountant. 
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Once you've got the hang of it you can code any system from a book on trading - or buiid one yourseif. 

— Special thanks to Geoff Mulhall for original article in the newsletter that was the basis of this tutorial — 
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Creating your own indicators 

There are two ways to create your own indicators: 

1) using drag-and-drop interface 

2) by writing your own formula 

First method, using drag-and-drop interface is very simple and does not require writing single line of code. To 
learn more about drag-and-drop indicator creation please check Tutorial: Flow to use drag-and-drop charting 
interface 

Second method involves writing an indicator formula in flexible AFL (AmiBroker Formula Language). You can 
find the description of this language in AFL Reference Guide section of user's guide. Here we will present 
basic steps needed to define and display your own custom indicator. In this example we will define an 
"indicator" that will show line volume graph (opposite to built-in bar volume graph). 

Just follow these steps 

1. Select Analysis->Formula Editor option from the menu as shown below: 




lol 

Analysis 

Tools Window Help 


Quick Review... 



5 Automatic Analysis... 


.0 ^ 

^ Commentary... 

9,159 


^ Formula Editor.. 
AFL Code Wizar 



2. You will see the following dialog displayed on the screen: 



It presents an empty Formula Editor window. 
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3. Now single-click in the edit field located in the editor toolbar to change the name of the indicator: 



Now you can edit the name of the custom indicator. Give it the name "My own indicator". After you 
press ENTER key the caption will be updated with the new file name as shown below: 


^ [Formulas\Custom\My own Bdicator.afI] 

Formula Editor | <=i || B [|i£^| 

File Edit lools Help 1 

□ H - # ^ 

own indicator ''ty ►E] - 


Caption bar shows the path under which formula file will be stored. By 
default it is stored under "Formulas/Custom" subfolder and the name of the 
file corresponds to indicator name. 


4. Now type the formula: 


Plot ( Volvime, "My volume chart", colorGreen ); 

This formula instructs AmiBroker to plot built-in Volume array. Second parameter specifies the title of 
the plot and third parameter defines the color. The picture below shows formula editor after entering 
the code: 



5. Now click Apply indicator toolbar button (or choose Tools->Apply indicator menu) as shown in the 
picture and close editor by pressing X button in the upper right corner of the editor window. 


Now the indicator you have just written is displayed as a chart. You can also find it stored as a formula in 
Chart tree: 
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Charts _ -p X 

f Price ■» 

f Price (all in one) 
f Price (foreign) 

/ Relative Performance 
f Volume 
f Volume (color) 
f Volume At Price 
f Volume At Price Multi 
/ Bollinger Bands 
bU Custom K 

/ I- ■ - I ^ 

/ Unnamed 1 
f Unnamed 2 
f Unnamed 3 
f Unnamed 4 
/ Unnamed 5 
f Unnamed 6 
H i ~l Drag-drop 

/ _Accumulation_Distribution 
/ _ADLine 
' / -ADX 


Now you can improve your indicator by adding Param functions so both coior and style of the plot can be 
modified using Parameters dialog. To do so, click with RIGHT mouse button over chart pane and select Edit 
Formula (or press Ctrl-rE) 


HPQ- 

HPQ (Daily) x | 

My volume chart = 129,159.0000 

d 





Parameters... 

iSr ■■ 

i 



7 

. 

Edit formula... ^ 

Intraday ^ 

d Daily view 

w Weekly view 

m Monthly view 

r 





HPQ - Dally 2009-09-14 Open 45.33, Hi 46, Lo 4 

129,155 


And modify the formula to: 


Plot ( Volume, "My volume chart", ParamColor ( "Color" , colorGreen ), 

ParamStyle ( "Style" , 0, maskAll ) ) ; 

Then press Apply indicator to apply the changes. Now click with RIGHT mouse button over chart pane again 
and select Parameters (or press Ctrl-rR) and you will see parameters dialog allowing to modify colors and 
styles used to plot a chart: 
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Also in the "Axes & Grid" tab you will be able to change settings for axes, grids and other charting options 
referring to this particular chart: 


Properties of: My own indicator 



Reset all 



For further information on creating your indicators please check Using graph styles and colors tutorial section 

For further reference on using Formula Editor please consult Environment - Formula Editor and AmiBroker 
Formula Language - AFL Tools sections of AmiBroker User's guide and using AFL editor. 
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Using graph styles, colors, titles and parameters in Indicators 

AmiBroker provides customizabie styies and coiors of graphs in custom indicators. These features aiiow more 
fiexibiiity in designing your indicators. This articie wiii expiain how to use styies and coiors. It wiii aiso expiain 
how to define chart titie that appears at the top of the chart. 

Plot() function 

Plot is the function used to plot a chart. It takes 9 parameters, out of which first 3 are required. 

Plot( array, name, color, style = styleLine, minvalue = Null, maxvalue = Null, XShlft= 0, ZOrder= 0, width = 1 

) 


• array parameter represents data to be plotted, 

• name parameter defines the name of the graph (used in title string to show the values of the 
indicator), 

• co/or parameter defines the color of plot, 

• style defines "the look" of the chart (i.e. line/histogram/candlestick/bar, etc). Default style is line. 

• minvalue and maxvalue are rarely used paremeters that define hard-coded minimum and maximum 
values used when graph uses "independent" scaling, i.e. styleOwnScale is specified in style 
parameter. Usually you don't need to specify them at all. 

• XS/?/Yf allows shifting chart past the last bar (for example displaced moving averages or projections 
into the future) 

• ZOrder- defines the Z-axis position of given plot. The default is zero. Zorder = 0 means also where 
the "grid" is located. So if you want to plot BEHIND the grid you need to specify negative zorder 
parameter.Plots are drawn in the following order: 

zorder parameter takes precedence over the order of calling Plot() functions, so if z-order is set, it 
determines plotting order. See this picture. If multiple plots use the same z-order parameter they are 
plotted in reverse call order (ones that appear last in the code are plotted first). This rule can be 
changed by already existing switch graphzorder = 1 which, when specified, reverses this behaviour 
(so plots are drawn in call order). Please note the above applies to each zorder "layer" separately (so 
within same zorder "layer" reverse call rule applies) 

• width - (new in 5.60) defines pixel or percent width of given plot. The default is 1 pixel. Positive values 
specify PIXEL width, negative values specify width in percent of current bar width. So for example -20 
will give you dynamic width that is 20% of bar width. 

An example, the following single function call plots a RSI indicator with red color line: 

Plot( RSI (14), "My RSI", colorRed ); 

As you can see we have provided only first three (required) parameters. First parameter is the array we need 
to plot. In our example it is RSI(14) indicator. Second parameter is just the name. It can be any name you 
want. It will be displayed in the title line along with indicator value as shown in the picture below: 


rINTC- My RSI = 41.74- 


Third parameter is the color. To specify plot color you can use one of the following pre-defined constants: 
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Color constants 


Custom colors refer to color user-defined palette editable using Tools->Preferences->Colors, the numerical 
values that appear after = (equation) mark are for reference only and you don't need to use them. Use just 
the name such as colorDarkGreen. 

colorCustomI = 0 
colorCustom2 = 1 
colorCustomS = 2 
colorCustom4 = 3 
colorCustomS = 4 
colorCustornG = 5 
colorCustom7 = 6 
colorCustomS = 7 
colorCustom9 = 8 
colorCustomI 0 = 9 
colorCustom11=10 
colorCustomI 2 = 11 
colorCustomI 3 = 12 
colorCustomI 4 = 13 
colorCustomI 5 = 14 
colorCustomI 6 = 15 

colorBlack = 16 
colorBrown = 17 
colorDarkOllveGreen = 18 
colorDarkGreen = 19 
colorDarkTeal = 20 
colorDarkBlue = 21 
colorindigo = 22 
colorDarkGrey = 23 

colorDarkRed = 24 
colorOrange = 25 
colorDarkYellow = 26 
colorGreen = 27 
colorTeal = 28 
colorBlue = 29 
colorBlueGrey = 30 
colorGrey40 = 31 

colorRed = 32 
colorLIghtOrange = 33 
colorLIme = 34 
colorSeaGreen = 35 
colorAqua = 35 
colorLIghtBlue = 37 
colorVlolet = 38 
colorGrey50 = 39 

colorPInk = 40 
colorGold = 41 
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colorYellow = 42 
colorBrightGreen = 43 
colorTurquoise = 44 
colorSkyblue = 45 
colorPlum = 46 
colorLightGrey = 47 

colorRose = 48 
colorTan = 49 
colorLightYellow = 50 
colorPaleGreen = 51 
colorPaleTurquoise = 52 
colorPaleBlue = 53 
colorLavender = 54 
colorWhite = 55 

You can also use new 24-bit (full color palette) functions ColorRGB and ColorHSB 

You can easily plot multi colored charts using both Plot functions. All you need to do is to define array of color 
indexes. 

In the following example MACD is plotted with green color when it is above zero and with red color when it is 
below zero. 

dynamic_color = Ilf ( MACD () > 0, colorGreen, colorRed ); 

Plot ( MACD (), "My MACD", dynamic_color ); 

In addition to defining the color we can supply 4th parameter that defines style of plot. For example we can 
change previous MACD plot to thick histogram instead of line: 

dynamic_color = IIf( MACD () > 0, colorGreen, colorRed ) ; 

Plot ( MACD (), "My MACD", dynamic_color, styleHistogram 
styleThick ); 

As you can see, multiple styles can be combined together using | (binary-or) operator. (Note: the | character 
can be typed by pressing backslash key 'V while holding down SHIFT key). Resulting chart looks like this: 


rINTC - My MACD = -0.07- 

0.80 

0.40 



mmr v H 

in I 

-0.80 

'I||||k* . .IMilMMI|| 

i|]l' ” 




To plot candlestick chart we are using styleCandle constant, as in this example: 

Plot ( Close, "Price", colorBlack, styleCandle ); 

To plot traditional bars with color (green up bars and red down bars) we just specify color depending on 
relationship between open and close price and styleBar in style argument: 

Plot ( Close, "Price", IIf( Close > Open, colorGreen, colorRed ), 
StyleBar styleThick ) ; 
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All available style constants are summarized In the table below. 


Style constants 


Style Is defined as a combination (using either addition (+) or blnary-or (|) operator) of one or more following 
flags ( you can use predefined style_constants Instead of numbers) 

styleLlne = 1 - normal (line) chart (default) 

styleHlstogram = 2 - histogram chart 

styleThIck =4 - fat (thick) 

styleDots = 8 - Include dots 

styleNoLlne = 16 - no line 

styleDashed = 32 - dashed line style 

styleCandle = 64 - candlestick chart 

styleBar = 128 - traditional bar chart 

styleNoDraw = 256 - no draw (perform axis scaling only) 

styleStaIrcase = 512 - staircase (square) chart 

styleSwIngDots = 1024 - middle dots for staircase chart 

styleNoRescale = 2048 - no rescale 

styleNoLabel = 4096 - no value label 

stylePoIntAndFIgure = 8192 - point and figure 

styleArea = 16384 - area chart (extra wide histogram) 

styleOwnScale = 32768 - plot Is using Independent scaling 

styleLeftAxIsScale = 65536 - plot Is using left axis scale (Independent from right axis) 
styleNoTItle = 131072 - do not Include this plot value In title string 
styleCloud = 262144 - paint a "cloud" (filled area) chart (see examples below) 

styleCllpMInMax = 524288 - clip area between Min and Max levels defined In Plot statement. (Note: this style 
Is not compatible with most printers) 

styleGradlent - (new In 5.60) - gradient area chart. Upper gradient color Is specified by color parameter In 
Plot() function, bottom gradient color Is either background color or can be defined using SetGradlentFIII 
function. StyleGradlent can be combined with styleLlne 

Not all flag combinations make sense, for example (64+1) (candlestick + line) will result In candlestick chart 
(style=64) 

Note on candlestick/bar charts: If these styles are applied to Plot() function then they use Indirectly O, H, L 
arrays. 

If you want to specify your own OHL values you need to use PlotOHLC() function. 

New StyleCloud and styleCllpMInMax styles bring new Interesting possibilities shown In the sample Image 
below: 
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The formula for chart in the middle pane (rainbow 24-bit multiple moving averages) looks as follows: 

side = 1; 

increment = Param (" Increment ", 2 , 1 , 10, 1 ) ; 
for (i=10; i<80; i=i + increment ) 

{ 

up = MA ( C, i ); 

down = MA ( C, i + increment ); 

if ( ParamToggle ( "3D effect?", "No|Yes", 1 ) ) 

side = IIf(up<=down AND Ref ( up<=down, 1 ), 1, 0.6 ) ; 

PlotOHLC ( up,up,down,down, "MA"+i, ColorHSB ( 3*(i - 10), 

Param (" Saturation" , 128, 0, 255 ), 

side * Param ( "Brightness" , 255, 0, 255 ) ), styleCloud | styleNoLabel 


} 

The formula for the chart in the lower pane (slow stochastic %K with colored tops and bottoms) looks as 
follows. It uses styleClipMinMax to achieve clipping of the cloud region between min and max levels specified 
in the plot statement. Without this style area between min/max would be filled. Please note that due to 
Windows GDI limitation clipping region (styleClipMinMax) is supported only on raster (bitmap) devices so it is 
not compatible with printers or WMF (windows metafile) output. 
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SetChartOptions ( 0 , 0 ,ChartGridSO | ChartGrid70 ); 
r = StochK ( 14 ); 

Plot ( r, "StochK", colorBlack ); 

PlotOHLC ( r,r,50,r, IIf( r > 50, colorRed, colorGreen ), styleCloud | 

styleClipMinMax, 30, 70 ) ; 

X-shift feature 

The XShift parameter allows to displace (shift) the plot In horizontal direction by specified number of bars. This 
allows to plot displaced moving averages and projections Into the future. See the following sample code of 
displaced moving average: 

Periods = Param ( "Periods" , 30, 2, 100 ) ; 

Displacement = Param ( "Displacement" , 15, -50, 50 ) ; 

Plot ( MA( C, Periods ), _DEFAULT_NAME(), ColorCycle, styleLine, 0, 0, 

Displacement ); 

PlotForeignQ function 

It Is now easy to overlay price plots of multiple symbols using PlotForeIgn function: 

PlotForelgn( tickersymbol, name, color/barcolor, style = styleCandle j styleOwnScale, minvalue= {empty}, 
maxvalue = (empty), xshift = 0) 

Plots the foreign-symbol price chart (symbol Is defined by tickersymbol parameter). Second argument name 
defines graph name used for displaying values In a title bar. Graph color could be static (If third argument Is a 
number) or dynamic (when third argument Is an array). Color Indexes are related to the current palette (see 
Preferences/Color) 

style defines chart plot style (see Plot() function for possible values) 

PlotForeign ( "''DJI", "Dow Jones", colorRed ) ; 

PlotForeign ( "''NDX", "Nasdaq 100", colorBlue ) ; 

PlotForeign ( "''IXIC", "Nasdaq Composite", colorGreen ) ; 

Multiple plots using different scaling 

Two new styles can be used to plot multiple graphs using different Y-scale: styleOwnScale and 
styleLeftAxIsScale. 

It also makes It easy to plot 2 or more "own scale" plots with the same scaling: 

minimum = LastValue( Lowest( Volume ) ); 

maximum = LastValue( Highest( Volume ) ); 

Plot ( Close, "Price", colorBlue, styleCandle ); 

/* two plots below use OwnScale but the scale is common because we 
set min and max values of Y axis */ 

Plot( Volume, "Volume", colorGreen, styleHistogram | styleThick | 
StyleOwnScale, minimum, maximum ); 

Plot( MA( Volume, 15 ), "MA volume", colorRed, styleLine | 


Using graph styles, colors, titles and parameters in Indicators 


183 


AmiBroker 6.00 User's Guide 


Tutorial 


styleOwnScale, minimum, maximum ) ; 

New style: styleLeftAxisScale = 65536 - allows to plot more than one graph using common scaling but 
different from regular (right axis) scale. 

Example: price plot plus volume and moving average plot: 

// Plot price plot and its moving average 

Plot ( Close, "Price", colorWhite, styleCandle ); 

Plot( MA( Close, 20 ), "MAC", colorRed ); 

// Now plot volume and its moving average using left-hand axis 
scaling 

Plot( Volume , "Volume", colorBlue, styleLeftAxisScale 
styleHistogram | styleThick ); 

Plot( MA( Volume,15), "MAV", colorLightBlue, styleLeftAxisScale ); 

New parameters make It also easy to plot ribbons, for example: 

Plot( Close, "Price", colorBlue, styleCandle ); 

Plot( 2, /* defines the height of the ribbon in percent of pane width 
*/ 

"Ribbon", 

IIf( up, colorGreen, IIf( down, colorRed, 0 )), /* choose color */ 
StyleOwnScaleIstyleAreaIstyleNoLabel, -0.5, 100 ) ; 

Using custom defined parameters 

AmiBroker allows to create user-defined parameters. Such parameters are then available via Parameters 
dialog for quick and fast adjustment of Indicator. 

Most often used parameter functions are (click on the links to get more detailed description): 

• Param( "name", default, min, max, steps, Incr = 0 ) 

• ParamStr( "name", "default"); 

• ParamColor( "name", defaultcolor); 

• ParamStyle("name", defauitval = styleLlne, mask = maskDefault) 

They make It possible to define your own parameters In your Indicators. Once Param functions are Included In 
the formula you can right click over chart pane and select "Parameters" or press CtrkR, and change them via 
Parameters dialog and get Immediate response. 

The simplest case looks like this: 

period = ParamC'RSI period", 12, 2, 50, 1 ) ; 

Plot ( RSI ( period ), "RSI( " + period + ") ", colorRed ); 

Right click over the chart and choose "Parameters" and move the slider and you will see RSI plotted with 
different periods Immedlatelly as you move the slider. 

Sample code below shows how to use ParamStr to get the ticker symbol and ParamColor to get colors. 
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ticker = ParamStr( "Ticker", "MSFT" ); 
sp = Param( "MA Period", 12, 2, 100 ) ; 

PlotForeign ( ticker, "Chart of "+ticker, 

ParamColor ( "Price Color", colorBlack ), styleCandle ); 

Plot ( MA ( Foreign ( ticker, "C" ), sp ), "MA", ParamColor ( "MA Color", 

colorRed ) ) ; 

The following sample formula (from AmiBroker mailing list) that allows to visually align price peak/troughs with 
sine curve on the chart: 

Cycle = ParamC'Cycle Months", 12, 1, 12, 1 ) *22 ; //264==12mth,22==lmth 

xfactor = Param (" Stretch" , 1 , 0.1 , 2 , 0. 1 );// l==lyr,2==2yr 

xshift = Param (" slide" , 0 , -22 , 22 , 2 ) /3 .141 6''2 ;/ /slide curve l==5days 

X = 2*3 . 1416/Cycle/xfactor; 
y = sin (Cum (x)-xshift) ; 

Plot (C, "Daily Chart", colorBlack, styleCandle | styleNoLabel); 

Plot (y, 

"cycle =" + WriteVal (Cycle*xf actor/22 , 1 .0 ) +"months" , 

colorBlue,styleLine styleNoLabel styleOwnScale); 

Right click over the chart and choose "Parameters" and move the sliders and you will see chart immediatelly 
reflecting your changes. 

For more information on user-definable parameters please check also Tutorial: Using drag-and-drop interface 

Plotting texts at arbitrary positions on the chart 

AmiBroker now allows annotation of the chart with text placed on any x, y position specified on the formula 
level using new PlotText function. 

PlotText( "text", x, y, color, bkcolor = colorDefault) 

where 

X - is x-coordinate in bars (like in LineArray) 
y - is y-coordinate in dollars 

color is text color, bkcolor is background color. If bkcolor is NOT specified (or equal to colorDefault) text is 
written with TRANSPARENT background, any other value causes solid background with specified background 
color 

Example: 

Plot (C, "Price" , colorBlack, styleLine ); 

Plot (MA(C, 20) , "MA20", colorRed ) ; 

Buy=Cross( C, MA(C,20 ) ) ; 

Sell= Cross ( MA ( C, 20 ), C ) ; 

dist = 1 . 5*ATR (10) ; 
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for ( i = 0; i < BarCount; i++ ) 


if( Buy[i] ) 
if( Sell[i] 
colorYellow 

} 


PlotText ( "Buy\n@" + C[ i 
PlotText ( "Sell\n@" + C[ 


] , i, L [ i 
i ] , i, H [ 


]-dist[i], 
i ] +dist[ i 


colorGreen 
, colorRed, 


PlotShapes ( Buy * shapeUpArrow + Sell * shapeDownArrow, Ilf ( Buy, colorGreen, 
colorRed ) ); 


Gradient fill of the background 

AmiBroker 4.90 allows to fill indicator background with gradually changing color. To achieve this you need to 
use new function SetChartBkGradientFill( topcolor, bottomcolor, titlebkcolor = default) 

The function enables background gradient color fill in indicators. 

Please note that this is independent from chart background color (background color fills entire pane, gradient 
fill is only for actual chart interior, so axes area is not affected by gradient fill). Parameters are as follows: 

topcolor - specifies top color of the gradient fill 
bottomcolor - specifies bottom color of the gradient fill 

titlebkcolor - (optional) the background color of title text. If not specified then top color is automatically used for 
title background. 

Example: 


SetChartBkGradientFill ( ParamColor ( "BgTop" , colorWhite), ParamColor ( "BgBottom" , 

colorLightYellow)); 

Gradient fill area charts 


Version 5.60 brings native gradient area charts. To display a simple gradient chart it is enough to use 
styleGradient in the Plot() function call. By default upper gradient color is specified by color parameter in Plot() 
function, bottom gradient color is either background color. styleGradient can be combined with styleLine. 

A simple gradient area chart can be displayed using: 

Plot ( C, "C", colorDefault, styleGradient | styleLine ); 

For detailed control over gradient colors and baseline there is an extra function SetGradientFill( topcolor, 
bottomcolor, baseline, baselinecolor) that should be called before Plot(). 

When you use SetGradientFill function, the upper gradient color is specified by topcolor argument, bottom 
gradient color is specified by botttomcolor. Optional parameters (baseline/baselinecolor) allow reverse 
gradient chart (such as underwater equity) and 3 color gradients top->baseline->bottom. See code for 
Underwater Equity for example usage of reverse gradient chart (with baseline at the top). Baseline parameter 
specifies the Y-axis position of chart baseline. The baselinecolor parameter specifies the color of gradient that 
is to be used at that level. If baselinecolor is not specified, then only 2-color gradient is plotted 
(topcolor->bottomcolor). 

For example to display three-color gradient Rate Of Change that will use green as "top" color for positive 
values, background color as "baseline" color and red as "bottom" color for negative values it is enough to 


Using graph styles, colors, titles and parameters in Indicators 


186 


AmiBroker 6.00 User's Guide 


Tutorial 


write: 


SetGradientFill ( colorGreen /*top*/, colorRed /*bottom*/, 0 /*baseline level*/, 
GetChartBkColor () /*basellne color */); 

Plot ( ROC ( C, 14), "ROC", colorLightOrange, styleLine | styleGradient, Null, 
Null, 0,-1 ); 


The resulting chart will look as follows (using Basic chart theme): 
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.. or this way (using Black chart theme): 



Super thick charts 

Version 5.60 allows to define the line width beyond styleThick that was the only option before. 

Now 9th parameter of PlotQ defines pixel or percent width of given plot. The default is 1 pixel. Positive values 
specify pixel width, negative values specify width in percent of current bar width. So for example -20 will give 
you dynamic width that is 20% of bar width. Example: 

Plot ( C, "Close", colorDefault, styleBar, Null, Null, 0, 1, -20 /* line width as 
percent of bar */ ); 

As you zoom-in the bars will become thicker and thicker. 

Now you can get super thick lines as shown in the example below (10-pixel thick line chart): 

Plot ( C, "Close", colorRed, styleLine, Null, Null, 0, 1, 10 /* 10 pixel wide */ 

) ; 
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Miscellaneous 

As you already know each plot has Its own name that Is used to create a title string which displays names and 
values of Indicators. AmiBroker however allows you to override this automatic mechanism and define your 
own title string from the scratch. The Title reserved variable Is used for that. You just assign a string to It and 
It will be displayed In the chart Instead of automatically generated one. 

Also there two more reserved variables (GraphXSpace and GraphZOrder) that allow to fine-tune Indicator 
look. 

They are all described In the table below. 


Variable 

Usage 

Applies to 

Title 

Defines title text 

If you use Title variable you can specify colors In the string. 

It Is advised to use AFL EncodeColor function that makes It easier than 
coding escape sequences. 

EncodeColor( colornumber). 

And you can write the above example like this: 

Title = "This Is written In " + EncodeColor( colorVlolet) -i- "violet color" -i- 
EncodeColor( colorGreen ) + "and this In green"; 

Multi-line caption Is possible by simply embedding line break \n, for 
example: 

Title = "This Is 1st llne\nThls Is second line"; 

For sake of completeness: colors can also be specified using espace 
sequences but It Is NOT recommended because Is hard to write and hard 
to read. WcXX sequence where XX Is 2 digit number specifying color 

Index \\c38 - defines violet, there Is a special sequence \\c-1 that resets to 
default axis color. 

For example 

Title = "This Is written In \\c38vlolet color \\c27and this In green"; 

Indicators 

Tooltip 

Obsolete in 5.40. Use Data window Instead or use Plot() with 
styleHIdden If you want to add your custom values to data tooltip. 

For example: 

Plot( my value, "MyValueForTooltIp", colorBlack, styleHIdden ); 

Indicators 

GraphXSpace 

defines how much extra space should be added above and below graph 
line (In percent). 

For example: 

GraphXSpace = 5; 

Indicators 
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adds 5% extra space above and below the graph line. When 

GraphXSpace is not defined in the formula then default 2% is used. 


GraphLabelDecimals 

(new in 5.90) controls number of decimals in chart value labes (example, 
adding GraphLabelDecimals = 2; to the formula would give you value 
lables with 2 decimal places) 

Indicators 

GraphZOrder 

GraphZOrder variable allows to change the order of plotting indicator 
lines. When GraphZOrder is not defined or is zero (false) - old ordering 
(last to first) is used, when GraphZOrder is 1 (true) - reverse ordering is 
applied. 

Indicators 


Obsolete graph variables 


This table shows obsolete reserved variables. They are still functional for backward-compatibility but new 
code should use Plot() functions only. What's more, when using new Plot() functions vou should NOT use 
obsolete variables below. 


Variable 

Usage 

Applies to 

maxgraph 

specifies maximum number of graphs to be drawn in custom indicator window 
(default=3) 

Indicators 

graphA/ 

defines the formula for the graph number N (where A/ is a number 0,1,2,..., 
maxgraph-1) 

Indicators 

graph A/open, 

graphA/high, 

graphA/low, 

define additional 0, H, L price arrays for candlestick and traditional bar charts 

Indicators 

graphA/color 

defines the color index of A/th graph line. Color indexes are related to the 
current palette - see Preferences/Color. 

Indicators 

graphA/barcolor 

defines the array that holds palette indexes for each bar drawn 

Indicators 

graphA/style 

defines the style of /Vth graph. Style is defined as a combination (sum) of one or 

more following flags ( you can use predefined style_constants instead of 

numbers) 

Indicators 
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How to create your own exploration 

One of the most useful features of the Analysis window is called "Exploration". Basically, an exploration works 
in a similar way to scan but instead of looking for and reporting just buy/sell signals it allows you to generate 
customizable screening (or exploration) report that can give you much more information than simple scan. 

The idea behind an exploration is simple - one variable called filter controls which symbols/quotes are 
accepted. If "true" (or 1) is assigned to that variable for given symbol/quote it will be displayed in the report. 

So, for example, the following formula will accept all symbols with closing prices greater than 50 : 

filter = close > 50; 

(NOTE: To create new formula please open Formula Editor using Analysis->Formula Editor menu, type the 
formula and choose Tools->Send to Analysis menu In Formula editor) 

Note that exploration uses all range and filter settings that are also used by back-tester and scanning modes 
so you can get multiple signals (report lines) if you select "All quotations" range. To check just the most 
recent quote you should choose "1 recent bar(s)" 

Now, what about customizable reports? 

Yes, exploration mode allows you to create and then export a report with completely customizable columns 
and it is quite simple to do. 

All you have to do is to tell AmiBroker what columns do you want. This can be done by calling AddColumn 
function in your exploration formula: 

AddColumn( Close, "Close" ); 

The first argument of AddColumn function is the data ARRAY you want to display, the second argument 
defines the column caption 

If you now press "Explore" button in the Analysis window you will get the result similar to this: 
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Note that there are actually 3 columns: predefined Ticker and Date/Time column and one custom 
columnholding close price. Note that only tickers with close price greater than 50 are reported. 

Now you can click "Export" and your exploration will be saved to CSV (comma separated values) file that 
could be easily loaded to any other program Including Excel for further analysis. 

Actually AddColumn function accepts more arguments to allow you to customize the output even more. The 
full syntax Is: 

AddColumn( array, name, format = 1.2, textColor = colorDefault, bkgndColor = colorDefault) 

format parameter allows you to define the formatting applied to numbers. By default all variables are 
displayed with 2 decimal digits, but you can change this by assigning a different value to this variable: 1.5 
gives 5 decimal digits, 1.0 gives no decimal digits. So, In our example, typing: 

AddColumn( Close, "Close", 1.4 ) ; 

will give closing prices displayed with 4 decimal digits. 

(Note for advanced users: the integer part of this number can be used to pad formatted number with spaces - 6.0 wiil give no decimai digits but a number 
space-padded upto 6 characters.) 

There are also special format pre-defined constants that allow to display date/time and single character 
codes: 


• formatDateTIme - produces date time formated according to your system settings 

AddColumn ( DateTimeO, "Date / Time", formatDateTIme ) ; 

• formatChar - allows outputting single ASCII character codes: 
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Example (produces signal file accepted by various other programs): 

Buy=Cross(MACD(),Signal ()); 

Sell=Cross(Signal 0, MACD()); 

Filter=Buy OR Sell; 

SetOption("NoDefaultColumns", True ); 

AddColumn ( DateTimeO, "Date", formatDateTime ); 

AddColumn( IIf( Buy, 66, 83 ), "Signal", formatChar ); 

textColor and bkgndColor arguments allow you to produce colorful reports. By default result list is displayed 
using system color but you can override this behaviour providing your own colors. 

For example, the code that displays close price in green color when 1 day rate of change is positive and 
otherwise uses red color: 

AddColumn( Close, "Close", 1.4, IIF( ROC(C, 1 ) > 0, colorGreen, colorRed ) ); 

Examples 

The exploration mode is extermely flexible: you can, for example, export the whole database to CSV file using 
the following formula: 

filter = 1; /* all symbols and quotes accepted */ 

AddColumn(Open,"Open",1.4); 

AddColumn(High,"High",1.4); 

AddColumn(Low,"Low",1.4); 

AddColumn(Close,"Close",1.4); 

AddColumn(Volume,"Volume",1.0); 

This one will show you only heavily traded securities: 

filter = volume > 5000000; /* adjust this threshold for your own 
needs */ 

AddColumn(Close,"Close",1.4); 

AddColumn(Volume,"Volume",1.0); 

or...just show securities with volume being 30% above its 40-day exponential average 

filter = volume > 1.3 * ema( volume, 40 ); 

AddColumn(Close,"Close", 1.4) ; 

AddColumn(Volume,"Volume",1.0); 

With this one, you can export multiple indicator values for further analysis: 

filter = close > ma( close, 20 ); /* only stocks trading above its 20 
day MA*/ 

AddColumn( macd(), "MACD", 1.4 ); 

AddColumn( signal (), "Signal", 1.4 ); 

AddColumn( adx(), "ADX", 1.4 ); 

AddColumn( rsi(), "RSI", 1.4 ); 

AddColumn( roc( close, 15 ), "ROC(15)", 1.4 ); 

AddColumn( mfi(), "MFI", 1.4 ); 
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AddColumn( obv(), "OBV", 1.4 ); 

AddColumn( cci(), "CCI", 1.4 ); 

AddColumn( ultimate(), "Ultimate", 1.4 ) ; 

One more example of color output: 

Filter =1; 

AddColumn( Close, "Close", 1.2 ); 

AddColumn( MACD(), "MACD", 1.4 , IIf( MACD() > 0, colorGreen, 

colorRed ) ) ; 

AddTextColumn( FullNameO, "Full name", 77 , colorDefault, IIf( Close 
< 10, colorLightBlue, colorDefault ) ); 

Scatter (X-Y) charts in Exploration 

Version 5.60 brings a new feature to the exploration - scatter X/Y charts. Scatter charts are useful to display 
relationships between many symbols such as correlation, risk, etc. They can be seen as replacement and 
upgrade to "RIsk/yleld" map that was hard coded to just one function. Now you can code your own X-Y charts 
that are not limited to just risk/yleld maps. 

All you need to do to display your own scatter plot Is to add XYChartAddPoInt to your formula for each X-Y 
point you want to have on your chart. 

For example you can get scatter plot of MFE/ProfIt and MAE/ProfIt relationships as shown In the description of 
XYChartAddPoInt AFL function. 

To display risk/yleld scatter chart using new functions follow the steps below. 

1 . Click File->New->Analysis 

2. Pick "Formulas\Exploratlon\RlskYleld.afl" file (listed below) 

3. Click on Explore button In the new Analysis window 

4. In the bottom row of tabs you will see new "RIsk/Yleld" tab, click on It and you will see XY chart generated 
during exploration: 
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You can hover the mouse over that X-Y chart to read the values and you can click, drag to mark rectangle to 
zoom in. Click without marking rectangle restores full view. 


// XY scatter chart example 

// This is AFL equivalent of Risk-Yield map 
// Note that this exploration should be run on 
// WEEKLY data 

// it calculates average weekly gain (yield) 

// and standard deviation of gains (risk) 

Filter=Status ( "lastbarinrange" ); 

Length = SelectedValue ( BarIndexO ); 

Chg = ROC ( C, 1 ); //one bar yield 
yield = MA ( Chg, Length - 1 ); 
risk = StDev ( Chg, Length - 1 ); 

AddColumn (yield, "yield" ) ; 

AddColumn (risk, "risk" ) ; 

Clr = ColorHSB ( 2 * Status ("stocknum" ) % 255, 255, 255 ); 


XYChartAddPoint ( "Risk/Yield" , Name(), risk[ Length ], yield[ Length ] , Clr ); 

XYChartSetAxis ( "Risk/Yield" , "Risk[%]", "Yield[%]") ; 

Final tip 
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Please don't forget that you can sort the results of the exploration by any column by simply clicking on Its 
header. 
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How to write your own chart commentary 

One of the interesting aspects of using AmiBroker Formuia Language is writing automatic chart 
commentaries. The idea behind this technique is as foiiows: 

1. You write the commentary formuia that consists of two basic elements: static texts and AFL 
expressions 

2. AmiBroker evaluates expressions using currently selected symbol data and generates dynamic 
content 

3. The mixture of static text and evaluated formulas are displayed in commentary output window 

4. Additionally buy/sell arrows are plotted on the chart 

Commentaries are available from Analysis->Comrnentary menu. When you open commentary window you will 
see two tabs: Commentary and Formula. In the Formula tab you can type the AFL statements which will be 
evaluated by AmiBroker resulting in dynamic commentary that appears in Commentary lab. The following 
sections will guide you through the steps needed to write your very own commentary formulas. 

Writing static texts 

Static text elements written in the formula should be enclosed in the quotation marks and terminated by 
semicolon sign as shown below: 

"This is sample static text statement"; 

You can write several statements and each statement will be placed in a new line in the commentary output 
window: 


"This is first line of text"; 

"This is second line of text"; 

Please type these examples into edit field in the Formula tab and switch to Commentary [ah. You will see the 
texts displayed in the output area but without any quotation marks or semicolons. This is because AmiBroker 
has evaluated this simple text statements into strings and it displayed the strings in the output window. 

Instead of just typing the text, it is advised that any new code should use printf function instead. 

printf ( "This is sample static text statement" ); 

To write several lines of text you can use a couple of statements as shown above or you can do this using 
single statement and line break sequence ('\n'): 

printf ( "This is first line of textXnThis is second line of 
textXnThis is third line of text" ); 

You can also concatenate the string constants which will result in single line text: 

printf ( "This" + 

" is" + 

" single"+ 

" line" + " of text" ); 
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Colors and styles 

Since version 5.90 commentary and interpretation windows support coiors and boid/itaiic styies. To specify 
beginning and end of boid section use <b> and </b> tags. To specify beginning and end of itaiic section use 
<l> and </l> tags. To change text color use EncodeColor as shown in the example below: 

printf ( "<b>Bold text</b>\n" ); 
printf ("<i>Italic text</i>\n" ); 

printf ("Now " + EncodeColor ( colorRed ) + "red textXn"); 

printf ("and finally " + EncodeColor ( colorGreen ) + "green <b>AND bold <i>AND 

italic</i></b>\n" ); 

printf(EncodeColor ( colorBlack ) + "going back to black"); 

Dynamic content 

I guess that you are quite bored with these simple examples, let's start with some dynamic content. 

To enable dynamic commentaries AFL has a couple of special functions available, but two of them are the 
most important: NumToStr() and WritelF(). WritelF() function is used for conditional text display and will be 
described later in this article, now let us see what we can do using NumToStr() function. 

The AFL reference manual says: 


NumToStr( NUMBER ); 

NumToStr( ARRAY); 

STRING 

This function can only be used within an Guru commentary. It is used to 
display the numeric value of NUMBER or ARRAY. 


SYNTAX 


RETURNS 

FUNCTION 


So, if you want to display a value of a number or currently selected bar of the array you should use 
NumToStrO function. But... wait a minute - what does it mean "currently selected bar of the array"? Let me 
explain this using simple formula (please type it in the Formula tab): 

printf ( NumToStr( close ) ); 

When you switch to Commentary tab you will see the value of closing price (the same one which is displayed 
at the top of main price chart). But when you click on the chart in another place, selecting different date and 
then you click "Refresh" button you will see different value - the closing price at day you have selected. So 
NumToStr( close ) function displays the value of currently selected bar of close array. And it works exactly the 
same way with other arrays. If you write 

printf ( NumToStr( macd() ) ) ; 

you will see the exact value of MACD indicator at the day you have selected in the main chart. Having our 
current know-how we are able to write some statistics: 

printf ( "Closing price = " + NumToStr( close ) + "\n" ); 

printf ( "Change since yesterday = " + NumToStr( close - ref ( close, 

-1 ) ) + "\n" ); 

printf ( "Percent chg. since yesterday = " + NumToStr( roc ( close, 1 ) 


) + " %%\n" ); 

printf ( "MACD =" + NumToStr( macd() ) + " , Signal line =" + 
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NumToStr( signal () ) + "\n" ); 

When you switch to Commentary tab you will see output similiar to this one: 

Closing price = 17.940 

Change since yesterday = -0.180 

Percent chg. since yesterday = -0.993 % 

MACD = -0.001 , Signal line = 0.063 

Quite nice, isn't it? You can also write current symbol ticker and selected date using name() and date() 
functions as shown below: 

printf ( "Statistics of " + name() + " as of " + date() ); 


Instead of using NumToStr to convert number to string, we can format numbers directly using printf flexible % 
format specifiers. For example using %.2f means write a number with 2 decimal places, %.3f will mean write a 
number with 3 decimal places, %g will mean write a number with minimum required number of digits 
(auto-format). So we could write our previous example as follows: 

printf ( "Closing price = %.3f\n", close ); 

printf ( "Change since yesterday = %.3f\n", close - ref ( close, -1 ) ) ; 
printf ( "Percent chg. since yesterday = %.2f%%\n", roc ( close, 1 ) ); 
printf ( "MACD = %.4f. Signal line = %.4f\n", macd(), signal () ) ; 

As we can see this code is shorter and clearer. The first argument of printf function is a string (strictly 
speaking so called formatting string that contains text and number placeholders/format specifiers marked with 
%. Subsequent arguments of printf function are actual values (numbers) we want to write (without need to 
convert to string anymore). As you may have noted, if we want to specify just percent sign, not a formatting 
sequence, we need to write %% (two percent signs). 

But what we miss here is an ability to write something if some condition is met and write something different 
otherwise... 

Conditional text output 

AFL is equipped with very nice function called WritelF() that can output different texts depending on the 
condition. Let us look what documentation says: 


SYNTAX 

RETURNS 

FUNCTION 


writeif( EXPRESSION, "TRUE TEXT", "FALSE TEXT") 

STRING 

This function can only be used within an Guru commentary. If EXPRESSION 
evaluates to "true", then the TRUE TEXT string is displayed within the 
commentary. If EXPRESSION evaluates to "false", then the FALSE TEXT 
string is displayed. 


So we can easily output different text depending on expession, for example: 

writeif( macd() > signal(), "The MACD is bullish because is is above 
it's signal line", "The MACD is bearish because it is below its 
signal line" ); 
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You can also combine several Writelf() function calls in order to handle more possibilities: 

"The current market condition for "+ name() + " is: 


avgcondl = ( c > ema( close, 200) ) + 0.1 * ( close > ema( close, 90) 

) + 0.1 * ( close > ema( close , 30 ) ) ; 

avgcond2 = -( c < ema( close, 200) ) - 0.1 * ( close < ema( close, 

90) ) - 0.1 * ( close < ema( close , 30 ) ); 


Writelf( avgcondl 
"Very Bullish", 
Writelf( avgcondl 
"Bullish", 

Writelf( avgcondl 
"Mildly Bullish", 


== 1 . 2 , 

== 1 . 1 , 

== 1 . 0 , 

"") ) ) + 


Writelf( avgcond2 
"Very Bearish", 
Writelf( avgcond2 
"Bearish", 

Writelf( avgcond2 
"Mildly Bearish", 


== - 1 . 2 , 

== - 1 . 1 , 

== - 1 . 0 , 

"") ) ) ; 


The formula above will return the text "The current market condition for {your ticker here} is: Very Bullish" if 
close price is above 30 day average and close is above 90 day average and close is above 200 day average. 
In other cases the formula will give you Bullish, Mildly Bullish, Mildly Bearish, Bearish or Very Bearish ratings. 

For more examples on AFL commentaries please check AFL formula library especially MACD commentary 
formula which demonstrates all techniques presented here. 

Now you are ready to start with your own commentaries... Good luck! 


How to write your own chart commentary 


199 


AmiBroker 6.00 User's Guide 


Tutorial 


Using studies in AFL formulas 

AmiBroker 3.52 introduces abiiity to reference hand-drawn studies from AFL formuias. This feature is quite 
unique among trading software and as you wiii find out using this feature is quite easy. 

I wiii show you an example how to check if the trend line is broken from AFL code. All we need to do is three 
simple steps: 

1. Draw a trend line 

2. Define study ID 

3. Write the formula that checks trend line break 

Drawing trend line 

A trend line is a sloping line drawn between two prominent points on a 
chart. 


In this example we will draw the rising trend line that defines the uptrend. 
This kind of trend line is usually drawn between two (or more) troughs 
(low points) to illustrate price support. 

For sure you know how to draw a trend line in AmiBroker - just select a 
"Trend line" tool from "Draw" toolbar, find at least two recent troughs and 
just draw the line. 

Define study ID 

As you probably know, you can modify the properties of each line drawn 
in AmiBroker by clicking with the right mouse button over the study and 
selecting "Properties" from the menu. The properties dialog that shows up 
allows you to define exact start/end points and choose line colour, style 
and left and/or right extension mode. 


For further analysis we will use the right-extended trend line (click on 
appropriate checkbox) to make sure that the trend line is automaticaly 
extended when new data are added. 

Since version 3.52 the properties dialog allows also to define "Study ID" (the combo below colour box). "Study 
ID" is a two-letter code of the study that can be assigned to any study within a chart that allows AmiBroker to 
reference it from AFL. Predefined identifiers are: "UP" - uptrend, "DN" - downtrend, "SU" - support, "RE" - 
resistance, "ST" - stop loss, however you can use ANY identifiers (there are no limitations except that 
AmiBroker accepts only 2 letter codes). This way if you draw the support lines in many symbols and give them 
all "SU" identifier then you will be able to reference the support line from AFL code. 
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So we will assign the "SU" study ID to the rising support trend line we have just drawn. 

Write the formula that checks trend line break 

In this example we will detect if the closing price drops BELOW support trend line. This is actually very simple: 

sell = cross ( study ( "SU" ), close, GetChartIDO ) ; 

Note that study() function accepts two arguments: the first is StudylD two letter code that corresponds to one 
given in properites dialog; the second argument is chart ID - it should be taken either via GetChartlD() function 
(then it refers to current indicator) or read from Parameter dialog, Axes & Grid: Miscellaneous: Chart ID. 
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Back-testing your trading ideas 

Introduction 

One of the most useful things that you can do in the analysis window is to back-test your trading strategy on 
historical data. This can give you valuable insight into strengths and weak points of your system before 
investing real money. This single AmiBroker feature is can save lots of money for you. 

Writing your trading rules 

First you need to have objective (or mechanical) rules to enter and exit the market. This step is the base of 
your strategy and you need to think about it yourself since the system must match your risk tolerance, portfolio 
size, money management techniques, and many other individual factors. 

Once you have your own rules for trading you should write them as buy and sell rules in AmiBroker Formula 
Lanugage (plus short and cover if you want to test also short trading). 

In this chapter we will consider very basic moving average cross over system. The system would buy 
stocks/contracts when close price rises above 45-day exponential moving average and will sell 
stocks/contracts when close price falls below 45-day exponential moving average. 

The exponential moving average can be calculated in AFL using its built-in function EMA. All you need to do is 
to specify the input array and averaging period, so the 45-day exponential moving average of closing prices 
can be obtained by the following statement: 

ema( close, 45 ) ; 

The close identifier refers to built-in array holding closing prices of currently analysed symbol. 

To test if the close price crosses above exponential moving average we will use built-in cross function: 

buy = cross( close, ema( close, 45 ) ) ; 

The above statement defines a buy trading rule. It gives "1" or "true" when close price crosses above ema( 
close, 45 ). Then we can write the sell rule which would give "1" when opposite situation happens - close price 
crosses below ema( close, 45 ): 

sell = cross( ema( close, 45 ), close ); 

Please note that we are using the same cross function but the opposite order of arguments. 

So complete formula for long trades will look like this: 

buy = cross( close, ema( close, 45 ) ) ; 

sell = cross( ema( close, 45 ), close ); 

NOTE: To create new formula please open Formula Editor using Analysis->Formula Editor menu, type the 
formula and choose Tools->Send to Analysis menu In Formula editor 

Back testing 
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To back-test your system just click on the Back test button in the Automatic analysis window. Make sure you 
have typed in the formula that contains at least buy and sell trading rules (as shown above). When the formula 
is correct AmiBroker starts analysing your symbols according to your trading rules and generates a list of 
simulated trades. The whole process is very fast - you can back test thousands of symbols in a matter of 
minutes. The progress window will show you estimated completion time. If you want to stop the process you 
can just click Cancel button in the progress window. 

Analysing results 

When the process is finished the list of simulated trades is shown in the bottom part of Automatic analysis 
window, (the Results pane). You can examine when the buy and sell signals occurred just by double clicking 
on the trade in Results pane. This will give you raw or unfiltered signals for every bar when buy and sell 
conditions are met. If you want to see only single trade arrows (opening and closing currently selected trade) 
you should double click the line while holding SHIFT key pressed down. Alternatively you can choose the type 
of display by selecting appropriate item from the context menu that appears when you click on the results 
pane with a right mouse button. 

In addition to the results list you can get very detailed statistics on the performance of your system by clicking 
on the Report button. To find out more about report statistics please check out report window description. 

Changing your back testing settings 

Back testing engine in AmiBroker uses some predefined values for performing its task including the portfolio 
size, periodicity (daily/weekly/monthly), amount of commission, interest rate, maximum loss and profit target 
stops, type of trades, price fields and so on. All these settings could be changed by the user using settings 
window. After changing settings please remember to run your back testing again if you want the results to be 
in-sync with the settings. 

For example, to back test on weekly bars instead of daily just click on the Settings button select Weekly from 
Periodicity combo box and click OK, then run your analysis by clicking Back test. 

Reserved variable names 

The following table shows the names of reserved variables used by Automatic Analyser. The meaning and 
examples on using them are given later in this chapter. 


Variable 

Usage 

Applies to 

buy 

defines "buy" (enter long position) trading rule 

Automatic 

Analysis, 

Commentary 

sell 

defines "sell" (close long position) trading rule 

Automatic 

Analysis, 

Commentary 

short 

defines "short" (enter short position - short sell) trading rule 

Automatic 

Analysis 

cover 

defines "cover" (close short position - buy to cover) trading rule 

Automatic 

Analysis 

buyprice 

defines buying price array (this array is filled in with the default values 
according to the Automatic Analyser settings) 

Automatic 

Analysis 
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sellprice 

defines selling price array (this array is filled in with the default values 
according to the Automatic Analyser settings) 

Automatic 

Analysis 

shortprice 

defines short selling price array (this array is filled in with the default values 
according to the Automatic Analyser settings) 

Automatic 

Analysis 

coverprice 

defines buy to cover price array (this array is filled in with the default 
values according to the Automatic Analyser settings) 

Automatic 

Analysis 

exclude 

If defined, a true (or 1) value of this variable excludes current symbol from 
scan/exploration/back test. They are also not considered in buy and hold 
calculations. Useful when you want to narrow your analysis to certain set 
of symbols. 

Automatic 

Analysis 

roundlotsize 

defines round lot sizes used by backtester (see explanations below) 

Automatic 
Analysis (new in 
4.10) 

ticksize 

defines tick size used to align prices generated by built-in stops (see 
explanations below) (note: it does not affect entry/exit prices specified by 
buyprice/sellprice/shortprice/coverprice) 

Automatic 
Analysis (new in 
4.10) 

pointvalue 

allows to read and modify future contract point value (see backtesting 
futures) 

CAVEAT: this AFL variable is by default set to 1 (one) regardless of 
contents of Information window UNLESS you turn ON futures mode 
(SetOption("FuturesMode", True )) 

Automatic 
Analysis (new in 
4.10) 

margindeposit 

allows to read and modify future contract margin (see backtesting futures) 

Automatic 
Analysis (new in 
4.10) 

positionsize 

Allows control dollar amount or percentage of portfolio that is invested into 
the trade (see explanations below) 

Automatic 
Analysis (new in 
3.9) 


Advanced concepts 


Until now we discussed fairly simple use of the back tester. AmiBroker, however supports much more 
sophisticated methods and concepts that will be discussed later on in this chapter. Please note that the 
beginner user should first play a little bit with the easier topics described above before proceeding. 

So, when you are ready, please take a look at the following recently introduced features of the back-tester: 

a) AFL scripting host for advanced formula writers 

b) enhanced support for short trades 

c) the way to control order execution price from the script 

d) various kinds of stops in back tester 

e) position sizing 

f) round lot size and tick size 

g) margin account 

h) backtesting futures 

AFL scripting host is an advanced topic that is covered in a separate document available here and I won't 
discuss it in this document. Remaining features are much more easy to understand. 

Short trade support 
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In the previous versions of AmiBroker, if you wanted to back-test system using both iong and short trades, you 
couid oniy simuiate stop-and-reverse strategy. When iong position was closed a new short position was 
opened immediatelly. It was because buy and sell reserved variables were used for both types of trades. 

Now (with version 3.59 or higher) there are separate reserved variables for opening and closing long and 
short trades: 

buy - "true" or 1 value opens long trade 
sell - "true" or 1 value closes long trade 
short - "true" or 1 value opens short trade 
cover - "true" or 1 value closes short trade 

Som in order to back-test short trades you need to assign short and cover variables. 

If you use stop-and-reverse system (always on the market) simply assign sell to short and buy to cover 

short = sell; 
cover = buy; 

This simulates the way pre-3.59 versions worked. 

But now AmiBroker enables you to have separate trading rules for going long and for going short as shown in 
this simple example: 

// long trades entry and exit rules: 
buy = cross( cci(), 100 ); 
sell = cross( 100, cci() ); 

// short trades entry and exit rules: 
short = cross( -100, cci() ); 
cover = cross( cci(), -100 ); 

Note that in this example if CCI is between -100 and 100 you are out of the market. 

Controlling trade price 

AmiBroker now provides 4 new reserved variables for specifying the price at which buy, sell, short and cover 
orders are executed. These arrays have the following names: buyprice, sellprice, shortprice and coverprice. 

The main application of these variables is controlling trade price: 

BuyPrice = IIF( dayofweekO == 1, HIGH, CLOSE ); 

// on monday buy at high, otherwise buy on close 

So you can write the following to simulate real stop-orders: 

BuyStop = ... the formula for buy stop level; 

SellStop = ... the formula for sell stop level; 

// if anytime during the day prices rise above buystop level 
(high>buystop) 

// the buy order takes place (at buystop or low whichever is higher) 

Buy = Cross( High, BuyStop ); 
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II if anytime during the day prices fall below sellprice level ( low 
< sellstop ) 

// the sell order takes place (at sellstop or high whichever is 
lower) 

Sell = Cross( SellPrice, SellStop); 

BuyPrice = max( BuyStop, Low ); // make sure buy price not less than 
Low 

SellPrice = min( SellStop, High ); // make sure sell price not 
greater than High 

Please note that AmiBroker presets buyprice, sellprice, shortprice and coverprice array variables with the 
values defined in system test settings window (shown below), so you can but don't need to define them in 
your formula. If you don't define them AmiBroker works as in the old versions. 

During back-testing AmiBroker will check if the values you assigned to buyprice, sellprice, shortprice, 
coverprice fit into high-low range of given bar. If not, AmiBroker will adjust it to high price (if price array value 
is higher than high) or to the low price (if price array value is lower than low) 
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Profit target stops 
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As you can see in the picture above, new settings for profit target stops are avaiiabie in the system test 
settings window. Profit target stops are executed when the high price for a given day exceedes the stop ievei 
that can be given as a percentage or point increase from the buying price. By defauit stops are executed at 
price that you define as seii price array (for iong trades) or cover price array (for short trades). This behaviour 
can be changed by using "Exit at stop" feature. 

"Exit at stop" feature 

If you mark "Exit at stop" box in the settings the stops wiil be executed at exact stop ievei, i.e. if you define 
profit target stop at +10% your stop and the buy price was 50 stop order wiil be executed at 55 even if your 
sell price array contains different value (for example closing price of 56). 

Maximum loss stops work in a similar manner - they are executed when the iow price for a given day drops 
below the stop level that can be given as a percentage or point increase from the buying price 

Trailing stops 

This kind of stop is used to protect profits as it tracks your trade so each time a position value reaches a new 
high, the trailing stop is placed at a higher level. When the profit drops below the trailing stop level the position 
is closed. This mechanism is illustrated in the picture below (10% trailing stop is shown): 



The trailing stop, as well as two other kind of stops could be enabled from user interface (Automatic analysis' 
Settings window) or from the formula level - using ApplyStop function: 


To reproduce the example above you would need to add the following code to your automatic analysis 
formula: 


ApplyStop( 2, 1, 10, 1 ); //10% trailing stop, percent mode, exit at stop ON 
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or you can write it using predefined constants that are more descriptive 
AppiyStop( stopTypeTraii, stopModePercent, 10, True ); 

Trailing stops could be also defined in points (dollars) and percent of profit (risk). In the latter case the amount 
parameter defines the percentage of profits that could be lost without activating the stop. So 20% percent of 
profit (risk) stop will exit your trade that has maximum profit of $100 when the profit decreases below $80. 

Dynamic stops 

The ApplyStopO function allows now to change the stop level from trade to trade. This enables you to 
implement for example volatility-based stops very easily. 

For example to apply maximum loss stop that will adapt the maximum acceptable loss based on 10 day 
average true range you would need to write: 

ApplyStop(0, 2, 2*ATR(10), 1 ); 

or you can write it using predefined constants that are more descriptive 
ApplyStop( stopTypeLoss, stopModePoint, 2 * ATR( 10 ), True ); 

The function above will place the stop 2 times 10 day ATR below entry price. 

As ATR changes from trade to trade - this will result in dynamic, volatility based stop level. Please note that 
3rd parameter of ApplyStop function (the amount) is sampled at the trade entry and held troughout the trade. 
So in the example above it uses ATR(IO) value from the date of the entry. Further changes of ATR do not 
affect the stop level. 

See complete APPLYSTOP function documentation for more details. 

Coding your own custom stop types 

ApplyStop function is intended to cover most "popular" kinds of stops. You can however code your own kind 
of stops and exits using looping code. For example the following re-implements profit target stop and shows 
how to refer to the trade entry price in your formulas: 

/* a sample low-level implementation of Profit-target stop in AFL: */ 

Buy = Cross ( MACD (), Signal () ); 

priceatbuy=0; 

for ( 1=0; 1 < BarCount; i++ ) 

{ 

if ( priceatbuy == 0 && Buy [ 1 ] ) 

priceatbuy = BuyPrice [ i ]; 

if ( priceatbuy > 0 && SellPrice [ i ] > 1.1 * priceatbuy ) 

{ 

Sellf 1 ] = 1; 

SellPrice [ 1 ] = 1.1 * priceatbuy; 
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priceatbuy = 0; 

} 

else 

Sell[ i ] = 0; 


Position sizing 

This is a new feature in version 3.9. Position sizing in backtester is impiemented by means of new reserved 
variabie 

PositionSize = <size array> 

Now you can controi doiiar amount or percentage of portfoiio that is invested into the trade 

• positive number define (doiiar) amount that is invested into the trade for exampie: 

PositionSize = 1000; // invest $1000 in every trade 

• negative numbers -100..-1 define percentage: 

-100 gives 100% of current portfoiio size, 

-33 gives 33% of avaiiabie equity for exampie: 

PositionSize = -50; /* aiways invest oniy haif of the current equity 7 

• dynamic sizing exampie: 

PositionSize = - 100 -i- RSi(); 

as RSi varies from 0..100 this wiii resuit in position depending on RSi vaiues -> iow vaiues of RSi wiii 
resuit in higher percentage invested 

if iess than 100% of avaiiabie cash is invested then the remaining amount earns interest rate as defined in the 
settings. 

There is aiso a new checkbox in the AA settings window: "Aiiow position size shrinking" - this controis how 
backtester handies the situation when requested position size (via PositionSize variabie) exceeds avaiiabie 
cash: when this fiag is checked the position is entered with size shinked to avaiiabie cash if it is unchecked 
the position is not entered. 

To see actuai position sizes piease use a new report mode in AA settings window: "Trade iist with prices and 
pos. size" 

For the end, here is an exampie of Tharp's ATR-based position sizing technique coded in AFL: 

Buy = <your buy formula here> 

Sell = 0; // selling only by stop 

TrailStopAmount = 2 * ATR( 20 ); 

Capital = 100000; /* IMPORTANT: Set it also in the Settings: Initial Equity */ 
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Risk = 0.01*Capital; 

PositionSize = (Risk/TrailStopAmount)*BuyPrice; 

ApplyStop( 2, 2, TrailStopAmount, 1 ); 

The technique could be summarized as follows: 

The total equity per symbol is $100,000, we set the risk level at 1% of total equity. Risk level is defined as 
follows: if a trailing stop on a $50 stock is at, say, $45 (the value of two ATR's against the position), the $5 
loss is divided into the $1000 risk to give 200 shares to buy. So, the loss risk is $1000 but the allocation risk is 
200 shares x $50/share or $10,000. So, we are 

allocating 10% of the equity to the purchase but only risking $1000. (Edited excerpt from the AmiBroker 
mailing list) 

Round lot size and tick size 

Round lot size 

Various instruments are traded with various "trading units" or "blocks". For example you can purchase 
fractional number of units of mutual fund, but you can not purchase fractional number of shares. Sometimes 
you have to buy in 10s or 100s lots. AmiBroker now allows you to specify the block size on global and 
per-symbol level. 

You can define per-symbol round lot size in the Symbol->lnformation page (pic. 3). The value of zero means 
that the symbol has no special round lot size and will use "Default round lot size" (global setting) from the 
Automatic Analysis settings page (pic. 1). If default size is set also to zero it means that fractional number of 
shares/contracts are allowed. 

You can also control round lot size directly from your AFL formula using RoundLotSize reserved variable, for 
example: 

RoundLotSize = 10; 

Tick size 

This setting controls the minimum price move of given symbol. You can define it on global and per-symbol 
level. As with round lot size, you can define per-symbol tick size in the Symbol->lnformation page (pic. 3). The 
value of zero instructs AmiBroker to use "default tick size" defined in the Settings page (pic. 1) of Automatic 
Analysis window. If default tick size is also set to zero it means that there is no minimum price move. 

You can set and retrieve the tick size also from AFL formula using TickSize reserved variable, for example: 

TickSize = 0.01; 

Note that the tick size setting affects ONLY trades exited by built-in stops and/or ApplyStop(). The backtester 
assumes that price data follow tick size requirements and it does not change price arrays supplied by the 
user. 

So specifying tick size makes sense only if you are using built-in stops so exit points are generated at 
"allowed" price levels instead of calculated ones. For example in Japan - you can not have fractional parts of 
yen so you should define global ticksize to 1, so built-in stops exit trades at integer levels. 


Margin account 
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Account margin setting defines percentage margin requirement for entire account. The defauit vaiue of 
Account margin is 100. This means that you have to provide 100% funds to enter the trade, and this is the 
way how backtester worked in previous versions. But now you can simuiate a margin account. When you buy 
on margin you are simpiy borrowing money from your broker to buy stock. With current reguiations you can 
put up 50% of the purchase price of the stock you wish to buy and borrow the other haif from your broker. To 
simulate this just enter 50 in the Account margin field (see pic. 1) . If your intial equity is set to 10000 your 
buying power will be then 20000 and you will be able to enter bigger positions. Please note that this settings 
sets the margin for entire account and it is NOT related to futures trading at all. In other words you can trade 
stocks on margin account. 

Additional settings 

• "Reverse entry signal forces exit" check box to the Backtester settings. 

When it is ON (the default setting) - backtester works as in previous versions and closes already open 
positon if new entry signal in reverse direction is encountered. If this switch is OFF - even if reverse 
signal occurs backtester maintains currently open trade and does not close positon until regular exit 
(sell or cover) signal is generated. 

In other words when this switch is OFF backtester ignores Short signals during long trades and 
ignores Buy signals during short trades. 

• "Allow same bar exit (single bar trade)" option to the Settings 

When it is ON (the default settings) - entry and exit at the very same bar is allowed (as in previous 
versions) 

if it is OFF - exit can happen starting from next bar only (this applies to regular signals,there is a 
separate setting for ApplyStop-generated exits). Switching it to OFF allows to reproduce the 
behaviour of MS backtester that is not able to handle same day exits. 

• "Activate stops immediately" 

This setting solves the problem of testing systems that enter trades on market open. In versions prior 
to 4.09 backtester assumed that you were entering trades on market close so built-in stops were 
activated from the next day. The problem was when you in fact defined open price as the trade entry 
price - then same day price fluctuations did not trigger the stops. There were some published 
workarounds based on AFL code but now you don't need to use them. Simply if you trade on open 
you should mark "Activate stops immediately" (pic. 1). 

You may ask why do not simply check the buyprice or shortprice array if it is equal to open price. 
Unfortunatelly this won't work. Why? Simply because there are doji days when open price equals 
close and then backtester will never know if trade was entered at market open or close. So we really 
need a separate setting. 

• "Use QuickAFL" 

QuickAFL(tm) is a feature that allows faster AFL calculation under certain conditions. Initially (since 
2003) it was available for indicators only, as of version 5.14-1- it is available in Automatic Analysis too. 

Initially the idea was to allow faster chart redraws through calculating AFL formula only for that part 
which is visible on the chart. In a similar manner, automatic analysis window can use subset of 
available quotations to calculate AFL, if selected “range” parameter is less than “All quotations". 

Detailed explanation on how QuickAFL works and how to control it, is provided in this Knowledge 
Base article: http://www.amibroker.eom/kb/2008/07/03/quickafl/ 
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Note that this option works not oniy in the backtester, but aiso in optimizations, expiorations and 
scans. 

See Also: 

Portfoiio-ievel backtesting article. 

Backtesting systems for futures contracts article. 

APPLYSTOP function description 
Using AFL editor section of the guide. 

Insider guide to backtester (newsletter 1/2002) 


Back-testing your trading ideas 


213 


AmiBroker 6.00 User's Guide 


Tutorial 


Portfolio-level backtesting 

IMPORTANT: Please read first Tutorial: Backtesting your trading ideas article 

New backtester works on PORTFOLIO LEVEL, it means that there is singie portfoiio equity and position 
sizing refers to portfolio equity. Portfolio equity is equal to available cash plus sum of all simultaneously open 
positions at given time. 

AmiBroker's portfolio backtester lets you combine trading signals and trade sizing strategies into simulations 
which exactly mimic the way you would trade in real time. A core feature is its ability to perform dynamic 
money management and risk control at the portfolio level. Position sizes are determined with full knowledge of 
what's going on at the portfolio level at the moment the sizing decision is made. Just like you do in reality. 

HOW TO SET IT UP ? 

There are only two things that need to be done to perform portfolio backtest 

1. You need to have first the formula that generates buy / sell / short /cover signals as described in 
"Backtesting your trading ideas" article 

2. You should define how many simultaneous trades you want to test and what position sizing algorithm you 
want to use. 

SETTING UP MAXIMUM NUMBER OF SIMULTANEOUSLY OPEN TRADES 

There are two ways to set the maximum number of simultaneously open trades: 

1 . Go to the Settings dialog, switch to Portfolio tab and enter the number to Max. Open Positions field 

2. Define the maximum in the formula itself (this overrides any setting in the Settings window) using SetOption 
function: 

SetOption("MaxOpenPositions", 5 ); // This sets maximum number of open positions 
to 5 

SETTING UP POSITION SIZE 

IMPORTANT: to enable more than one symbol to be traded you have to add PositionSize variable to your 
formula, so less than 100% of funds are invested in single security: 

PositionSize = -25; // invest 25% of portfolio equity in single trade 

or 

PositionSize = 5000; // invest $5000 into single trade 

There is a quite common way of setting both position size and maximum number of open positions so equity 
is spread equally among trades: 

PosQty =5; // You can define here how many open positions you want 
SetOption("MaxOpenPositions", PosQty ); 
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PositionSize = -100/PosQty; // invest 100% of portfolio equity divided by max. 
position count 

You can also use more sophisticated position sizing methods. For example volatility-based position sizing 
(Van Tharp-style): 

PositionSize = -2 * BuyPrice/(2*ATR(10)); 

That way you are investing investing 2% of PORTFOLIO equity in the trade adjusted by BuyPrice/2*ATR 
factor. 

USING POSITION SCORE 

You can use new PositionScore variable to decide which trades should be entered if there are more entry 
signals on different securities than maximum allowable number of open positions or available funds. In such 
case AmiBroker will use the absolute value of PositionScore variable to decide which trades are preferred. 
See the code below. It implements simple MA crossover system, but with additional flavour of preferring 
entering trades on symbols that have low RSI value. If more buy signals occur than available cash/max. 
positions then the stock with lower RSI will be preferred. You can watch selection process if you backtest with 
"Detailed log" report mode turned on. 

The code below includes also the example how to find optimum number of simultaneously open positions 
using new Optimization in Porfolio mode. 


^ -k -k -k -k -k 

** REGULAR PORTFOLIO mode 
** This sample optimization 

** finds what is optimum number of positions open simultaneously 

k k 

k k k k ^ 


SetOption("InitialEquity", 20000 ); 

SetTradeDelays(1,1,1,1) ; 

RoundLotSize = 1; 

posqty = Optimize("PosQty", 4, 1, 20, 1 ); 
SetOption("MaxOpenPositions" , posqty) ; 

// desired position size is 100% portfolio equity 
// divided by PosQty positions 

PositionSize = -100/posqty; 

// The system is very simple... 

// MA parameters could be optimized too... 
pi = 10; 
p2 = 22; 

// simple MA crossover 
Short=Cross( MA(C,pl) , MA(C,p2) ); 

Buy=Cross( MA(C,p2) , MA(C,pl) ); 

// always in the market 
Sell=Short; 
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Cover=Buy ; 

// now additional score 

// that is used to rank equities 

// when there are more ENTRY signals that available 
// positions/cash 

PositionScore = 100-RSI(); // prefer stocks that have low RSI; 

BACKTEST MODES 

AmiBroker 5.0 offers 6 different backtest modes: 

• reguiar mode (backtestReguiar) 

• reguiar raw mode (backtestReguiarRaw) 

• reguiar raw + muitipie positions mode (backtestReguiarRawMuiti) 

• reguiar raw2 mode (backtestReguiarRaw2) 

• regular raw2 + multiple positions mode (backtestRegularRaw2Multi) 

• rotational trading mode (backtestRotational) 

All "regular" modes use buy/sell/short/cover signals to enter/exit trades, while "rotational" mode (aka "ranking / 
switching" system) uses only position score and is descibed later. 

Backtest modes are switchable using SetBacktestMode() AFL function. 

The difference between "regular" modes is how repeated (also known as "redundant" or "extra") entry signals 
are handled. An "extra" entry signal is the signal that comes AFTER initial entry but before first matching exit 
signal. 

In the regular mode - the default one, redundant entry signals are removed as shown in the picture below. 
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RAW SIGNALS 
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PHASE 2 - PICKING TOP TRADES - MAX OPEN POS = 2, TRADES PICKED HAVE HIGHEST SCORE, ONCE PICKED, REMAIN IN PLACE 
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As you can see Buy-Sell signal pairs are matched and treated as a TRADE. If trade Is NOT entered on first 
entry signal due to weak rank, not enough cash or reaching the maximum open position count, subsequent 
entry signals are Ignored until matching exit signal. After exit signal, the next entry signal will be possible 
candidate for entering trade. The process of removing excess signals occurring after first buy and matching 
sell (and short-cover pair respectively) Is the same as ExRem() AFL function provides. To use regular mode 
you don't need to call SetBacktestMode function at all, as this Is the default mode. 

You may or may not consider removing extra signals desirable. If you want to act on ANY entry signal you 
need to use second mode - backtestRegularRaw. To turn It on you need to Include this line In the code: 

// signal-based backtest, redundant (raw) signals are NOT removed, only one 
position per symbol allowed 
SetBacktestMode ( backtestRegularRaw ); 

It does NOT remove redundant entry signals and will act on ANY entry provided that It Is scored highly 
enough and there Is a cash available and maximum number of open positions Is not reached. It will however 
allow only ONE OPEN POSITION per symbol at any given time. It means that If log trade Is already open and 
later In the sequence appears an extra buy signal. It will be Ignored until a "sell" signal comes (short-cover 
signals work the same). Note that you can still use sIgScaleln/sIgScaleOut to Increase or decrease the size of 
this existing position, but It will appear as single line In backtest result list. 

If you want ALL repeated entry signals to be acted and allow to open multiple, separate positions on the same 
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symbol without scaling in/out effect (so multiple positions on the same symbol open simultaneously appear as 
separate lines in the backtest report) you need to use backtestRegularRawMulti mode by adding the following 
line to the code: 

SetBacktestMode ( backtestRegularRawMulti ); 

In this mode MULTIPLE positions per symbol will be open if BUY/SHORT signal is "true" for more than one 
bar and there are free funds. Sell/Cover exit all open positions on given symbol, Scale-ln/Out work on all open 
positions of given symbol at once. 

Remark: The remaining modes are for advanced users only 

Raw2 modes are "special" for advanced users of custom backtester. They are only useful if you do custom 
processing of exit signals in custom backtester procedure. They should NOT be used otherwise, because of 
performance hit and memory consumption Raw2 modes cause. 

The common thing between Raw and Raw2 modes is that they both do NOT remove excess ENTRY signals. 
The difference is that Raw modes remove excess EXIT signals, while Raw2 do NOT. 

In Raw2 modes all exit signals (even redundant ones) are passed to second phase of backtest just in case 
that you want implement strategy that skips first exit. Lets suppose that you want to exit on some condition 
from first phase but only in certain hours or after certain numbers of bars in trade or only when portfolio equity 
condition is met. Now you can do that in Raw2 modes. 

Note that Raw2 modes can get significantly slower when you are using custom backtester code that iterates 
thru signals as there can be zillions of exit signals in the lists even for symbols that never generated any entry 
signals, therefore it is advised to use it only when absolutely necessary. Raw2 modes are also the most 
memory consuming. Note also that if you run the system WITHOUT custom backtest procedure there should 
be no difference between Raw and Raw2 modes (other than speed & memory usage) as first matching exit 
signal is what is used by default. 

ROTATIONAL TRADING 

Rotational trading (also known as fund-switching or scoring and ranking) is possible too. For more information 
see the description of EnableRotationalTrading function. 

HOLDMINBARS and EARLY EXIT FEES 

(Note that these features are available in portfolio-backtester only and not compatible with old backtester or 
EquityO function) 

HoldMinBars is a feature that disables exit during user-specified number of bars even if signals/stops are 
generated during that period 

Please note that IF during HoldMinBars period ANY stop is generated it is ignored. Also this period is ignored 
when it comes to calculation of trailing stops (new highest highs and drops below trailing stops generated 
during HoldMinBars are ignored).This setting, similar to EarlyExitFee/EarlyExitBars is available on per-symbol 
basis (i.e. it can be set to different value for each symbol) 

Example: 

SetOption ( "HoldMinBars" , 127 ); 

Buy=BarIndex() ==0 ; 

Sell=l; 
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II even if sell signals are generated each day, 

//they are ignored until bar 128 

Early exit (redemption) fee is charged when trade is exited during first N bars since entry. 

The fee is added to exit commission and you will see it in the commissions reported for example in detailed 
log. However, it is NOT reflected in the portfolio equity unless trade really exits during first N bars - this is to 
prevent affecting drawdowns if trade was NOT exited early. 

// these two new options can be set on per-symbol basis 
// how many bars (trading days) 

// an early exit (redemption) fee is applied 
SetOption ( "EarlyExitBars" , 128 ) ; 

// early redemption fee (in percent) 

SetOption ( "EarlyExitFee" , 2 ); 

(note 180 calendar days is 128 or 129 trading days) 

// how to set it up on per-symbol basis? 

// it is simple - use 'if statement 
if( NameO == "SYMBOLl" ) 

{ 

SetOption ( "EarlyExitBars" , 128 ) ; 

SetOption ( "EarlyExitFee" , 2 ) ; 

} 

if( NameO == "SYMBOL2" ) 

{ 

SetOption ( "EarlyExitBars" , 25 ) ; 

SetOption ( "EarlyExitFee" , 1 ) ; 

} 

In addition to HoldMinBars, EarlyExitBars there are sibling features (added in 4.90) called HoldMinDays and 
EarlyExitDays that work with calendar days instead of data bars. So we can rewrite previous examples to 
use calendar days accurately: 


// even if sell signals are generated each day, 

//they are ignored until 180 calendar days since entry 
SetOption ( "HoldMinBars" , 180 ); 

Buy=Bar Index () ==0 ; 

Sell=l; 

// these two new options can be set on per-symbol basis 
// how many CALENDAR DAYS 

// an early exit (redemption) fee is applied 
SetOption ( "EarlyExitDays" , 180 ) ; 

// early redemption fee (in percent) 

SetOption ( "EarlyExitFee" , 2 ); 

(note 180 calendar days is 128 or 129 trading days) 
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II how to set it up on per-symbol basis? 

// it is simple - use 'if' statement 
if( NameO == "SYMBOLl" ) 

{ 

SetOption ( "EarlyExitDays" , 180 ); 

SetOption ( "EarlyExitFee" , 2 ) ; 

} 

if( NameO == "SYMBOL2" ) 

{ 

SetOption ( "EarlyExitDays" , 30 ); 

SetOption ( "EarlyExitFee" , 1 ); 

} 

RESOLVING SAME BAR, SAME SYMBOL SIGNAL CONFLICTS 

It is possible for the system to generate on the very same symbol both entry and exit signal at the very same 
bar. Consider for example, this very simple system that generates buy and sell signals on every bar: 

Buy = 1; 

Sell = 1; 

If you add an exploration code to it to show the signals: 

AddColumn (Buy, ''Buy" , 1.0 ) ; 

AddColumn (Sell, "Sell", 1.0 ) ; 

Filter = Buy OR Sell; 

you will get the following output (when you press Explore); 


IBM (Dai^ Analysisl x f O | _ 

ml Scan dVExplore ^Backtest ^ '^Optimize 
Applyto 'Current T Range From-To date 
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1 

1 
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1 

1 

IBM 
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1 

1 
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1 

1 

IBM 
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1 

1 
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2011-12-16 

1 

1 


Now because of the fact that entry and exit signals do NOT carry any timing information, so you don't know 
which signal comes first, there are three ways how such conflicting same bar, entry and exit signals may be 
interpreted: 

1 . only one signal Is taken at any bar, so trade that begins on bar 1 ends on bar 2 and next trade may 
only be open on bar 3 and closed on bar 4 
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2. both signals are used and entry signal precedes exit signal, so trade that begins on bar 1 ends on 
bar 1, then text trade opens on bar 2 and ends on bar 2, and so on (we have single-bar trades and we 
are out of market between bars) 

3. both signals are used and entry signal comes after exit signal. In this situation the very first signal 
(exit) is ignored because we are flat, and trade is open on same bar entry signal. Then we don't have 
any more signals for given bar and trade is closed on the next bar exit signal, then we get another 
entry (same bar). So trade that begins on bar 1 ends on bar 2, then text trade opens on bar 2 and 
ends on bar 3, and so on (we have trades that span between bars, but both exit and entry signal 
occuring on the very same bar are acted upon) 

Since, as we mentioned already, buy/sell/short/cover arrays do not carry timing information we have to 
somehow tell AmiBroker how to interpret such conflict. One would think that it is enough to set buyprice to 
open and sellprice to close to deliver timing information, but it is NOT the case. Price arrays themselves DO 
NOT provide timing information neither. You may ask why. This is quite simple, first of all trading prices do not 
need to be set to exact open/close. In several scenarios you may want to define buyprice as open + slippage 
and sellprice as close - slippage. Even if you do use exact open and close, it happens quite often that open is 
equal close (such ase defines a doji candlestick) and then there is no way to find out from price alone, 
whenever it means close or open. So again buyprice/sellprice/shortprice/coverprice variables DO NOT 
provide any timing information. 

The only way to control the way how same bar, same symbol entry/exit conflicts are resolved is via 

AllowSameBarExit option and HoldMinBars option. 

Scenario 1. Only one signal per symbol is taken at any bar 

This scenario is used when AllowSameBarExit option is set to False (turned off). 

In this case it does not really matter whether exit or entry was the first within single bar. It is quite easy to 
understand: on any bar only one signal is acted upon. So if we are flat on given symbol, then entry signal is 
taken (with buy signal taking precedence over short), other signals are ignored and we move to next bar. If 
we are long on given symbol, then sell signal is taken, trade is exited and we move to next bar ignoring other 
signals. If we are short on given symbol then cover signal is taken, trade is exited and we move to next bar 
again ignoring other signals. If there we are in the market but there is no matching exit signal - the position is 
kept and we move to next bar. 

SetOption ( "AllowSameBarExit" , False ); 

Buy = 1; 

Sell = 1; 

The following pictures show which signals are taken and resulting trade list. All trades begin one day and end 
next day. New trade is open on the following day. 
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Scenario 2. Both entry and exit signais are used and entry signai precedes exit signai 

This scenario is used when AiiowSameBarExit option is set to True (turned on) and HoidMinBars is set to 
zero (which is the defauit setting). 

in this case we simpiy act on both signais immediateiy (same bar). So if we are fiat on given symboi, then 
entry signai is taken (with buy signai taking precedence over short), but we do not move to the next bar 
immediateiy. instead we check if exit signais exist too. if we are iong on given symboi, then seii signai is 
taken, if we are short on given symboi then cover signai is taken. Oniy after processing aii signais we move to 
the next bar. 

SetOption ( "AiiowSameBarExit" , True ); 

Buy = 1; 

Sell = 1; 

The foiiowing pictures show which signais are taken and resuiting trade iist. As we can see, this time aii 
signais are acted upon and we have sequence of singie-bar trades. 
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Scenario 3. Both signals are used and entry signal comes after exit signal. 
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This scenario is used when AllowSameBarExit option is set to True (turned on) and HoldMinBars is set to 1 
(or more). 

in this case we simpiy act on both signais in singie bar, but we respect the HoidMinBars = 1 iimitation, so 
trade that was just open can not be dosed the same bar. So if we are iong on given symboi, then sell signai is 
taken, if we are short on given symboi then cover signai is taken. We don't move to next bar yet. Now if we 
are fiat on given symboi (possibiy just exited position on this bar exit signai), then entry signai is taken if any 
(with buy signal taking precedence over short) and then we move to the next bar. 

SetOption ( "AllowSameBarExit" , True ) ; 

SetOption ( "HoldMinBars" , 1 ); 

Buy=l; 

Sell=l; 

The foiiowing pictures show which signais are taken and resuiting trade iist. As we can see, again aii signais 
are acted upon BUT... trade duration is ionger - they are not same bar trades - they aii span overnight. 
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How does It work In portfolio case? 


The mechanism is the same regardiess if you test on singie symboi or muitipie symbois. First same-bar 
confiicts are resoived on every symboi separateiy the way described above. Then, when you test on muitipie 
symbois, resuiting trade candidates are subject to scoring by PositionScore described in eariier part of this 
document. 


Support for market-neutral, long-short balanced strategies 

An investment strategy is considered market neutrai if it seeks to entireiy avoid some form of market risk, 
typicaiiy by hedging. The strategy hoids Long / short equity positions, with iong positions hedged with short 
positions in the same and reiated sectors, so that the equity market neutrai investor shouid be iittie affected by 
sector- or market-wide events. This pieces, in essence, a bet that the iong positions wiii outperform their 
sectors (or the short positions wiii underperform) regardiess of the strength of the sectors. 

in version 5.20 the foiiowing backtester options have been added to simpiify impiementing market-neutrai 
systems: SeparateLongShortRank, MaxOpenLong, MaxOpenShort. 
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SeparateLongShortRank backtester option 

To enable separate long/short ranking use: 

SetOption("SeparateLongShortRank", True); 

When separate long/short ranking is enabled, the backtester maintains TWO separate "top-ranked" signal 
lists, one for long signals and one for short signals. This ensures that long and short candidates are 
independently even if position score is not symetrical (for example when long candidates have very high 
positive scores while short candidates have only fractional negative scores). That contrasts with the default 
mode where only absolute value of position score matters, therefore one side (long/short) may completely 
dominate ranking if score values are asymetrical. 

When SeparateLongShortRank is enabled, in the second phase of backtest, two separate ranking lists are 
interleaved to form final signal list by first taking top ranked long, then top ranked short, then 2nd top ranked 
long, then 2nd top ranked short, then 3rd top ranked long and 3rd top ranked short, and so on... (as long as 
signals exist in BOTH long/short lists, if there is no more signals of given kind, then remaining signals from 
either long or short lists are appended) 

For example: 

Entry signals(score):ESRX=Buy(60.93), GILD=Short(-47.56), CELG=Buy(57.68), MRVL=Short(-10.75), 
ADBE=Buy(34.75), VRTX=Buy(15.55), SIRI=Buy(2.79), 

As you can see Short signals get interleaved between Long signals even though their absolute values of 
scores are smaller than corresponding scores of long signals. Also there were only 2 short signals for that 
particular bar so, the rest of the list shows long signals in order of position score. Although this feature can be 
used independently, it is intended to be used in combination with MaxOpenLong and MaxOpenShort options. 

MaxOpenLong / MaxOpenShort backtester options 

MaxOpenLong - limits the number of LONG positions that can be open simultaneously 
MaxOpenShort - limits the number of SHORT positions that can be open simultaneously 

Example: 

SetOption("MaxOpenPositions", 15 ); 

SetOption("MaxOpenLong", 11 ); 

SetOption("MaxOpenShort", 7); 

The value of ZERO (default) means NO LIMIT. If both MaxOpenLong and MaxOpenShort are set to zero ( or 
not defined at all) the backtester works old way - there is only global limit active (MaxOpenPositions) 
regardless of type of trade. 

Note that these limits are independent from global limit (MaxOpenPositions). This means that MaxOpenLong 
-I- MaxOpenShort may or may not be equal to MaxOpenPositions. 

If MaxOpenLong -i- MaxOpenShort is greater than MaxOpenPositions then total number of positions allowed 
will not exceed MaxOpenPositions, and individual long/short limits will apply too. For example if your system 
MaxOpenLong is set to 7 and maxOpenShort is set to 7 and MaxOpenPositions is set to 10 and your system 
generated 20 signals: 9 long (highest ranked) and 11 short, it will open 7 long and 3 shorts. 

If MaxOpenLong -i- MaxOpenShort is smaller than MaxOpenPositions (but greater than zero), the system 
won't be able to open more than (MaxOpenLong-i-MaxOpenShort). 
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Please also note that MaxOpenLong and MaxOpenShort only cap the number of open positions of given type 
(long/short). They do NOT affect the way ranking Is made. I.e. by default ranking Is performed using 
ABSOLUTE value of positlonscore. 

If your position score Is NOT symetrical, this may mean that you are not getting desired top-ranked signals 
from one side. Therefore, to fully utilise MaxOpenLong and MaxOpenShort In rotational balanced ("market 
neutral") long/short systems It Is desired to perform SEPARATE ranking for long signals and short signals. To 
enable separate long/short ranking use: 

SetOptlon("SeparateLongShortRank", True); 

See Also: 

Backtesting your trading Ideas article. 

Backtesting systems for futures contracts article. 

Using AFL editor section of the guide. 

Insider guide to backtester (newsletter 1/2002) 
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Reading backtest report 

To view the report of last backest simply click Report button in the automatic analysis window. To view results 
of ALL past backtest, click drop down arrow on the Report button and choose Report Explorer option. This 
will display the Report Explorer window that will show the list of all backtests performed. If you double click on 
the line - detailed report will be shown. 

New report is hugely enhanced compared to old one. It includes separate statistics for all, long and short 
sides as well as large number of new metrics. You can get short help on given figure by hovering your mouse 
over given field name. You will see the description in the tooltip. Short explanations are provided also below: 

Exposure % - 'Market exposure of the trading system calculated on bar by bar basis. Sum of bar exposures 
divided by number of bars. Single bar exposure is the value of open positions divided by portfolio equity. 

Net Risk Adjusted Return % - Net profit % divided by Exposure % 

Annual Return % - Compounded Annual Return % (CAR) 

Risk Adjusted Return % - Annual return % divided by Exposure % 

Avg. Profit/Loss, also known as Expectancy ($) - (Profit of winners + Loss of losers)/(number of trades), 
represents expected dollar gain/loss per trade 

Avg. Profit/Loss %, also known as Expectancy (%) -'(% Profit of winners + % Loss of losers)/(number of 
trades), represents expected percent gain/loss per trade 

Avg. Bars Held - sum of bars in trades / number of trades 

Max. trade drawdown - The largest peak to valley decline experienced in any single trade. The lower the 
better 

Max. trade % drawdown - The largest peak to valley percentage decline experienced in any single trade. 

The lower the better 

Max. system drawdown - The largest peak to valley decline experienced in portfolio equity. The lower the 
better 

Max. system % drawdown - The largest peak to valley percentage decline experienced in portfolio equity. 
The lower the better 

Recovery Factor - Net profit divided by Max. system drawdown 

CAR/MaxDD - Compound Annual % Return divided by Max. system % drawdown. Good if bigger than 2 
RAR/MaxDD - Risk Adjusted Return divided by Max. system % drawdown. Good if bigger than 2. 

Profit Factor - Profit of winners divided by loss of losers 
Payoff Ratio - Ratio average win / average loss 

Standard Error - Standard error measures chopiness of equity line. The lower the better. 
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Risk-Reward Ratio - Measure of the relation between the risk inherent in a trading the system compared to 
its potential gain. Higher is better. Calculated as slope of equity line (expected annual return) divided by its 
standard error. 

Uicer index - Square root of sum of squared drawdowns divided by number of bars 

Uicer Performance index - (Annual profit - Tresury notes profit)/Ulcer lndex'>Ulcer Performance Index. 
Currently tresury notes profit is hardcoded at 5.4. In future version there will be user-setting for this. 

Sharpe Ratio of trades - Measure of risk adjusted return of investment. Above 1.0 is good, more than 2.0 is 
very good. More information http://www.stanford.edu/~wfsharpe/art/sr/sr.htm . Calculation: first average 
percentage return and standard deviation of returns is calculated. Then these two figures are annualized by 
multipling them by ratio (NumberOfBarsPerYear)/(AvgNumberOfBarsPerTrade). Then the risk free rate of 
return is subtracted (currently hard-coded 5) from annualized average return and then divided by annualized 
standard deviation of returns. 

K-Ratio - Detects inconsistency in returns. Should be 1.0 or more. The higher K ratio is the more consistent 
return you may expect from the system. Linear regression slope of equity line multiplied by square root of sum 
of squared deviations of bar number divided by standard error of equity line multiplied by square root of 
number of bars. More information: Stocks & Commodities V14:3 (115-118): Measuring System Performance 
by Lars N. Kestner 

Color-coding in the backtest report (new in 5.60) 

Version 5.60 brings enhanced backtest report: color-coding 'good' and 'bad' values in backtest report. Some 
of the metrics in the backtest report are color-coded. Blue means "neutral", Green means "good". Red means 
"bad". Metrics that are not colorized are always black. 

This color coding is of course arbitrary and should be used as guideance only. Treat 'red' as a warning flag 
and advice to check the value in detail. 

As of now the following metrics are colorized: 

Net Profit, Net Profit % - bad < 0, good > 0 

Annual Profit %, bad < 0, neutral betwen 0 and 10, good > 10 

RAR % bad < 0, good > (10 / Exposure) 

Avg. Profit/Loss all trades (Expectancy $) - bad < 0, good > 0 
Avg Profit/Loss % all trades (Expectancy %) - bad < 0, good > 0 

Max. system % drawdown - bad: dd worse than -30%, neutral: dd between -30 and -10%, good - -10% to 0% 
CAR/MaxDD, RAR/MaxDD - bad < 1, neutral between 1 and 2, good > 2 
Recovery factor - bad < 1, neutral between 1 and 2, good > 2 
Payoff ratio - bad < 1, neutral between 1 and 2, good > 2 

See Aiso: 

Old backtest report 

Backtesting your trading ideas article. 

Portfolio Backtesting article. 

Backtesting systems for futures contracts article. 


Using AFL editor section of the guide. 
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Insider guide to backtester (newsietter 1/2002) 
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How to optimize trading system 

NOTE: This is fairly advanced topic. Please read previous AFL tutorials first. 

Introduction 

The idea behind an optimization is simpie. First you have to have a trading system, this may be a simpie 
moving average crossover for exampie. In aimost every system there are some parameters (as averaging 
period) that decide how given system behaves (i.e. is is weii suited for iong term or short term, how does is 
react on highiy voiatiie stocks, etc). The optimization is the process of finding optimai vaiues of those 
parameters (giving highest profit from the system) for a given symboi (or a portfoiio of symbois). AmiBroker is 
one of the very few programs that aiiow you to optimize your system on muitipie symbois at once. 

To optimize your system you have to define from one upto ten parameters to be optimized. You decide what 
is a minimum and maximum aiiowabie vaiue of the parameter and in what increments this vaiue shouid be 
updated. AmiBroker then performs muitipie back tests the system using ALL possibie combinations of 
parameters vaiues. When this process is finished AmiBroker dispiays the iist of resuits sorted by net profit. 
You are abie to see the vaiues of optimization parameters that give the best resuit. 

Writing AFL formula 

Optimization in back tester is supported via new function caiied optimize. The syntax of this function is as 
foiiows: 

variabie = optimize( "Description", default, min, max, step)] 
where: 

variabie - is normai AFL variabie that gets assigned the vaiue returned by optimize function. 

With normai backtesting, scanning, expioration and comentary modes the optimize function returns default 
vaiue, so the above function caii is equivaient to: variabie = default] 

In optimization mode optimize function returns successive vaiues from min to max (inciusiveiy) with step 
stepping. 

"Description" is a string that is used to identify the optimization variabie and is dispiayed as a coiumn name in 
the optimization resuit iist. 

default is a defauit vaiue that optimize function returns in expioration, indicator, commentary, scan and normai 
back test modes 

min is a minimum vaiue of the variabie being optimized 
max is a maximum vaiue of the variabie being optimized 
step is an intervai used for increasing the vaiue from min to max 
Notes: 


• AmiBroker supports upto 64 caiis to optimize function (therefore upto 64 optimization variabies), note 
that if you are using exhaustive optimization then it is reaiiy good idea to iimit number of optimization 
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variables to just few. 

• Each call to optimize generate (max - min)/step optimization loops and multiple calls to optimize 
multiply the number of runs needed. For example optimizing two parameters using 10 steps will 
require 10*10 = 100 optimization loops. 

• Call optimize function only ONCE per variable at the beginning of your formula as each call generates 
a new optimization loops 

• Multiple-symbol optimization is fully supported by AmiBroker 

• Maximum search space is 2^^ (lO''^ = 10,000,000,000,000,000,000) combinations 

Examples 

1. Single variable optimization: 


sigavg = Optimize ( "Signal average", 9, 2, 20, 1 ) ; 

Buy = Cross ( MACD ( 12, 26 ), Signal ( 12, 26, sigavg ) ); 

Sell = Cross ( Signal ( 12, 26, sigavg ), MACD ( 12, 26 ) ); 

2. Two-variable optimization (suitable for 3D charting) 

per = Optimize ( "per" , 2, 5, 50, 1 ); 

Level = Optimize ( "level" , 2, 2, 150, 4 ); 

Buy=Cross( CCI (per), -Level ); 

Sell = Cross ( Level, CCI (per) ); 

3. Multiple (3) variable optimization: 


mfast = Optimize ( "MACD Fast", 12, 8, 16, 1 ); 
mslow = Optimize ( "MACD Slow", 26, 17, 30, 1 ); 
sigavg = Optimize ( "Signal average", 9, 2, 20, 1 ) ; 


Buy = Cross ( MACD ( mfast, mslow ) , Signal ( mfast, mslow, sigavg ) ); 

Sell = C ross ( Signal ( mfast, mslow, sigavg ), MACD ( mfast, mslow ) ); 

After entering the formula just click on Optimize button in "Automatic Analysis" window. AmiBroker will start 
testing all possible combinations of optimization variables and report the results in the list. After optimization is 
done the list of result is presented sorted by the Net % profit. As you can sort the results by any column in the 
result list it is easy to get the optimal values of parameters for the lowest drawdown, lowest number of trades, 
largest profit factor, lowest market exposure and highest risk adjusted annual % return. The last columns of 
result list present the values of optimization variables for given test. 

When you decide which combination of parameters suits your needs the best all you need to do is to replace 
the default values in optimize function calls with the optimal values. At current stage you need to type them by 
hand in the formula edit window (the second parameter of optimize function call). 

Displaying 3D animated optimization charts 

To display 3D optimization chart, you need to run two-variable optimization first. Two variable optimization 
needs a formula that has 2 Optimize() function calls. An example two-variable optimization formula looks like 
this: 
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per = Optimize ( "per" , 2, 5, 50, 1 ); 

Level = Optimize ( "level" , 2, 2, 150, 4 ); 

Buy=Cross( CCI (per), -Level ); 

Sell = Cross ( Level, CCI (per) ); 

After entering the formula you need to click "Optimize" button. 

Once optimization is complete you should click on the drop down 
arrow on Optimize button and choose View 3D optimization 
graph. In a few seconds a colorful three-dimensional surface plot 
will appear in a 3D chart viewer window. An example 3D chart 
generated using above formula is shown below. 




By default the 3D charts display values of Net profit against optimization variables. You can however plot 3D 
surface chart for any column in the optimization result table. Just click on the column header to sort it (blue 
arrow will appear indicating that optimization results are sorted by selected column) and then choose View 3D 
optimization graph again. 


By visualizing how your system's parameters affect trading performance, you can more readily decide which 
parameter values produce "fragile" and which produce "robust" system performance. Robust settings are 
regions in the 3D graph that show gradual rather than abrupt changes in the surface plot. 3D optimization 
charts are great tool to prevent curve-fitting. Curve-fitting (or over-optimization) occurs when the system is 
more complex than it needs to be, and all that complexity was focused on market conditions that may never 
happen again. Radical changes (or spikes) in the 3D optimization charts show clearly over-optimization areas. 
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You should choose parameter region that produces a broad and wide plateau on 3D chart for your real life 
trading. Parameter sets producing profit spikes will not work reliably in real trading. 

3D chart viewer controls 

AmiBroker's 3D chart viewer offers total viewing capabilities with full graph rotation and animation. Now you 
can view your system results from every conceivable perspective. You can control the position and other 
parameters of the chart using the mouse, toolbar and keyboard shortcuts, whatever you find easier for you. 
Below you will find the list. 

Mouse controls: 

- to Rotate - hold down LEFT mouse button and move in X/Y directions 

- to Zoom-in, zoom-out - hold down RIGHT mouse button and move in X/Y directions 

- to Move (translate) - hold down LEFT mouse button and CTRL key and move in X/Y directions 

- to Animate - hold down LEFT mouse button, drag quickly and release button while dragging 

Keyboard controls: 

SPACE - animate (auto-rotate) 

LEFT ARROW KEY - rotate vert, left 
RIGHT ARROW KEY - rotate vert, right 
UP ARROW KEY - rotate horiz. up 
DOWN ARROW KEY - rotate horiz. down 
NUMPAD -r (PLUS) - Near (zoom in) 

NUMPAD - (MINUS) - Far (zoom out) 

NUMPAD 4 - move left 
NUMPAD 6 - move right 
NUMPAD 8 - move up 
NUMPAD 2 - move down 
PAGE UP - water level up 
PAGE DOWN - water level down 

Smart (non-exhaustive) optimization 

Introduction 

AmiBroker now offers smart (non-exhaustive) optimization in addition to regular, exhaustive search. 
Non-exhaustive search is useful if number of all parameter combinations of given trading system is simply too 
large to be feasible for exhaustive search. 

Exhaustive search is perfectly fine as long as it is reasonable to use it. Let's say you have 2 parameters each 
ranging from 1 to 100 (step 1). 

That's 10000 combinations - perfectly OK for exhaustive search. Now with 3 parameters you got 1 million 
combinations - it is still OK for exhaustive search (but can be lenghty). With 4 parameters you have 100 
million combinations and with 5 parameters (1 ..100) you have 10 billion combinations. In that case it would be 
too time consuming to check all of them, and this is the area where non-exhaustive smart-search methods 
can solve the problem that is not solvable in reasonable time using exhaustive search. 

Quick Start 


Here is absolutely the SIMPLEST instruction how to use new non-exhaustive optimizer (in this case CMA-ES). 
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1. Open your formula in the Formula Editor 

2. Add this single line at the top of your formula: 

OptimizerSetEngine("cmae"); //you can also use "spso" or "trib" here 

3. (Optional) Select your optimization target in Automatic Analysis, Settings, "Walk-Forward" tab. 
Optimization target field. If you skip this step it will optimize for CAR/MDD (compound annual return divided 
by maximum % drawdown). 

and... that's it. 

Now if you run optimization using this formula, it will use new evolutionary (non-exhaustive) CMA-ES 
optimizer. 


How does it work ? 

The optimization is the process of finding minimum (or maximum) of given function. Any trading system can 
be considered as a function of certain number of arguments. The inputs are parameters and quotation data , 
the output is your optimization target 

(say CAR/MDD). And you are looking for maximum of given function. 

Some of smart optimization algorithms are based on nature (animal behavior) - PSO algorithm, or biological 
process - Genetic algorithms, 

and some are based on mathematical concepts derived by humans - CMA-ES. 

These algorithms are used in many different areas, including finance. Enter "PSO finance" or "CMA-ES 
finance" in Google and you will find lots of info. 

Non-exhaustive (or "smart") methods will find global or local optimum. The goal is of course to find global one, 
but if there is a single sharp peak 

out of zillions parameter combinations, non-exhaustive methods may fail to find this single peak, but taking it 
form trader's perspecive, finding single sharp peak is useless for trading because that result would be instable 
(too fragile) and not replicable in real trading. In optimization process we are rather looking for plateau regions 
with stable parameters and this is the area where intelligent methods shine. 

As to algorithm used by non-exhaustive search it looks as follows: 

a) the optimizer generates some (usually random) starting population of parameter sets 

b) backtest is performed by AmiBroker for each parameter set from the population 

c) the results of backtests are evaluated according to the logic of algorithm 
and new population is generated based on the evolution of results, 

d) if new best is found - save it and go to step b) until stop criteria are met 


Example stop criteria can include: 

a) reaching specified maximum iterations 

b) stop if the range of best objective values of last X generations is zero 

c) stop if adding 0.1 standard deviation vector in any principal axis direction does not change the value of 
objective value 
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d) others 

To use any smart (non-exhaustive) optimizer in AmiBroker you need to specify the optimizer engine you want 
to use in the AFL formuia using OptimizerSetEngine function. 

OptimizerSetEngine("name") 

The function seiects externai optimization engine defined by name. AmiBroker currentiy ships with 3 engines: 
Standard Particie Swarm Optimizer ("spso"), Tribes ("trib"), and CMA-ES ("cmae") - the names in braces are 
to be used in OptimizerSetEngine caiis. 

In addition to seiecting optimizer engine you may want to set some of its internai parameters. To do so use 
OptimizerSetOption function. 

OptimizerSetOption("name", vaiue ) function 

The function set additionai parameters for externai optimization engine. The parameters are 
engine-dependent. 

Aii three optimizers shipped with AmiBroker (SPSO, Trib, CMAE) support two parameters: "Runs" (number of 
runs) and "MaxEvai" (maximum evaiuations (tests)per singie run). The behaviour of each parameter is 
engine-dependent, so same vaiues may and usuaiiy wiii yieid different resuits with different engines used. 

The difference between Runs and MaxEvai is as foiiows. Evaiuation (or test) is singie backtest (or evaiuation 
of objective function vaiue). 

RUN is one fuii run of the aigorithm (finding optimum vaiue) - usuaiiy invoiving many tests (evaiuations). 

Each run simpiy RESTARTS the entire optimization process from the new beginning (new initiai random 
popuiation). 

Therefore each run may iead to finding different iocai max/min (if it does not find giobai one). So Runs 
parameter defines number of subsequent aigorithm runs. MaxEvai is the maximum number of evaiuations 
(bactests) in any singie run. 

If the problem is relatively simple and 1000 tests are enough to find global max, 5x1000 is more likely to find 
global maximum 

because there are less chances to be stuck in local max, as subsequent runs will start from different initial 
random population 

Choosing parameter values can be tricky. It depends on problem under test, its complexity, etc, etc. 

Any stochastic non-exhaustive method does not give you guarantee of finding global max/min, regardless of 
number of tests if it is smaller 

than exhaustive. The easiest answer is to : specify as large number of tests as it is reasonable for you in 
terms of time required to complete. 

Another simple advice is to multiply by 10 the number of tests with adding new dimension. That may lead to 
overestimating number 

of tests required, but it is quite safe. Shipped engines are designed to be simple to use, therefore 
"reasonable" default/automatic values are used so optimization can be usually run without specifying anything 
(accepting defaults). 

Caveat 

It is important to understand that all smart optimization methods work best in continuous parameter spaces 
and relatively smooth objective functions. If parameter space is discrete evolutionary algorithms may have 
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trouble finding optimum value. It is especially true for binary (on/off) parameters - they are not suited for any 
search method that uses gradient of objective function change (as most smart methods do). If your trading 
system contains many binary parameters, you should not use smart optimizer directly on them. Instead try to 
optimize only continuous parameters using smart optimizer, and switch binary parameters manually or via 
external script. 


SPSO - Standard Particle Swarm Optimizer 

Standard Particle Swarm Optimizer is based on SPS02007 code that is supposed to produce good results 
provided that correct parameters (i.e. Runs, MaxEval) are provided for particular problem. 

Picking correct options for the PSO optimizer can be tricky therefore results may significantly vary from case 
to case. 

SPSO.dll comes with full source codes inside "ADK" subfolder. 

Example code for Standard Particle Swarm Optimizer: 

(finding optimum value in 1000 tests within search space of 10000 combinations) 

OptimizerSetEngine("spso"); 

OptimizerSetOption("Runs", 1 ); 

OptimizerSetOption("MaxEval", 1000 ); 

si = OptimizeC's", 26, 1, 100, 1 ); 
fa = OptimizeC'f", 12, 1, 100, 1 ); 

Buy = Cross( MACD( fa, si), 0 ); 

Sell = Cross( 0, MACD( fa, si)); 


TRIBES - Adaptive Parameter-less Particle Swarm Optimizer 

Tribes is adaptive, parameter-less version of PSO (particle swarm optimization) non-exhaustive optimizer. For 
scientific background see: 

http://www.particleswarm.info/Tribes_2006_Cooren.pdf 

In theory it should perform better than regular PSO, because it can automatically adjust the swarm sizes and 
algorithm strategy to the problem being solved. 

Practice shows that its performance is quite similar to PSO. 

The Tribes.DLL plugin implements "Tribes-D" (i.e. dimensionless) variant. Based on 
http://clerc.maurice.free.fr/pso/Tribes/TRIBES-D.zip by Maurice Clerc. Original source codes used with 
permission from the author 

Tribes.DLL comes with full source code (inside "ADK" folder) 

Supported parameters: 

"MaxEval" - maximum number of evaluations (backtests) per run (default = 1000). 
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OptimizerSetOption("MaxEval", 1000 ); 

You should increase the number of evaluations with increasing number of dimensions (number of optimization 
params). 

The default 1000 is good for 2 or maximum 3 dimensions. 

"Runs" - number of runs (restarts), (default = 5 ) 

You can leave the number of runs at default value of 5. 

By default number of runs (or restarts) is set to 5. 


To use Tribes optimizer, you just need to add one line to your code: 
OptimizerSetEngine("trib"); 

OptimizerSetOption("MaxEval", 5000 ); // 5000 evaluations max 


CMA-ES - Covariance Matrix Adaptation Evolutionary Strategy optimizer 

CMA-ES (Covariance Matrix Adaptation Evolutionary Strategy) is advanced non-exhaustive optimizer. 

For scientific background see: 

http://www.bionik.tu-berlin.de/user/niko/cmaesintro.html 

According to scientific benchmarks outperforms nine other, most popular evolutionary strategies (like PSO, 

Genetic and Differential evolution). 

http://www.bionik.tu-berlin.de/user/niko/cec2005.html 

The CMAE.DLL plugin implements "Global" variant of search with several restarts with increasing population 
size 

CMAE.DLL comes with full source code (inside "ADK" folder) 

By default number of runs (or restarts) is set to 5. 

It is advised to leave the default number of restarts. 

You may vary it using OptimizerSetOption("Runs", N ) call, where N should be in range 1 ..10. 

Specifying more than 10 runs is not recommended, although possible. 

Note that each run uses TWICE the size of population of previous run so it grows exponentially. 

Therefore with 10 runs you end up with population 2^10 greater (1024 times) than the first run. 

There is another parameter "MaxEval". The default value is ZERO which means that plugin will automatically 
calculate MaxEval required. It is advised to NOT to define MaxEval by yourself as default works fine. 

The algorithm is smart enough to minimize the number of evaluations required and it converges very fast to 
solution point, so often it finds solutions faster than other strategies. 

It is normal that the plugin will skip some evaluations steps, if it detects that solution was found, therefore you 
should not be surprised that optimization progress bar may move very fast at some points. The plugin also 
has ability to increase number of steps over initially estimated value if it is needed to find the solution. Due to 
its adaptive nature, the "estimated time left" and/or "number of steps" displayed by the progress dialog is only 
"best guess at the time" and may vary during optimization course. 
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To use CMA-ES optimizer, you just need to add one iine to your code: 

OptimizerSetEngine("cmae"); 

This wili run the optimization with defauit settings which are fine for most cases. 

It should be noted, as it is the case with many continouos-space search algorithms, that decreasing "step" 
parameter in Optimize() funciton calls does not significantly affect optimization times. The only thing that 
matters is the problem "dimension", i.e. the number of different parameters (number of optimize function 
calls). The number of "steps" per parameter can be set without affecting the optimization time, so use the 
finest resolution you want. In theory the algorithm should be able to find solution in at most 900*(N+3)*(N+3) 
backtests where "N" is the dimension. In practice it converges a LOT faster. For example the solution in 3 
(N=3) dimensional parameter space (say 100*100*100 = 1 million exhaustive steps) can be found in as few as 
500-900 CMA-ES steps. 


Multi-threaded individual optimization 

Starting from AmiBroker 5.70 in addition to multiple-symbol multithreading, you can perform multi-threaded 
single-symbol optimization. To access this functionality, click on drop down arrow next to "Optimize" button in 
the New Analysis window and select "Individual Optimize". 
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Individual Optinj^e 


"Individual Optimize" will use all available processor cores to perform single-symbol optimization, making it 
much faster than regular optimization. 

In "Current symbol" mode it will perform optimization on one symbol. In "All symbols" and "Filter" modes it will 
process all symbols sequentially, i.e. first complete optimization for first symbol, then optimization on second 
symbol, etc. 

Limitations: 

1. Custom backtester is NOT supported (yet) 

2. Smart optimization engines are NOT supported - only EXHAUSTIVE optimization works. 

For explanation of these limitations see Tutorial: Efficient use of multi-threading. 

Eventually we may get rid of limitation (1) - when AmiBroker is changed so custom backtester does not use 
OLE anymore. But (2) is probably here to stay for long. 
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Walk-forward testing 

AmiBroker 5.10 features the automatic Waik-Forward test mode. 

The automatic Waik forward test is a system design and vaiidation technique in which you optimize the 
parameter values on a past segment of market data (”in-sample”), then verify the performance of the system 
by testing it forward in time on data following the optimization segment (”out-of-sample”). You evaluate the 
system based on how well it performs on the test data (”out-of-sample”), not the data it was optimized on. The 
process can be repeated over subsequent time segments. The following illustration shows how the process 
works. 

Walk-Forward Test procedure 



In-sample data (IS) - Optimization 
Out-of-sample data (OOS) - Verirication (backtest) 


The purpose of walk-forward test is to determine whenever the performance of optimized trading system is the 
realistic or the result of curve-fitting. The performance of the system can be considered realistic if it has 
predicitive value and performs good on unseen (out-of-sample) market data. When the system is properly 
designed, the real-time trading performance should be in relation to that uncovered during optimization. If the 
system is going to work in real trading, it must first pass a walk-forward test. In other words, we don't really 
care about in-sample results as they are (or should be) always good. What matters is out-of-sample system 
performance. It is the realistic estimate of how the system would work in real trading and will quickly reveal 
any curve-fitting issues. If out-of-sample performance is poor then you should not trade such a system. 

The premise of performing several optimization/tests steps over time is that the recent past is a better 
foundation for selecting system parameter values than the distant past. We hope is that the parameter values 
chosen on the optimization segment will be well suited to the market conditions that immediately follow. This 
may or may not be the case as markets goes through bear/bull cycle, so care should be taken when choosing 
the length of in-sample period. For more information about system design and verification using walk-forward 
procedure and all issues involved, we can recommend Howard Bandy's book: "Quantitative Trading Systems" 
(see links on AmiBroker page). 
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To use Walk-Forward optimization please follow these steps: 

1 . Goto Tools->Automatic Analysis 

2. Click Settings button, then switch to Walk-Forward tab 



3. Here you can see Walk forward settings for In-sample optimization, out-of-sample backtest 
Start and End dates mark initial period begin / end 

This period will be moved forward by Step until the End reaches the Last date. 

The Start date can move forward by step too, or can be anchored (constant) if Anchored check is 
on. 

If you mark Use today then Last date entered will be ignored and TODAY (current date) will be used 
instead. 

By default an “EASY MODE” is selected which simplifies the process of setting up WF parameters. 

It assumes that: 

a) Out-of-sample segment immediatelly follows in-sample segment 

b) the length of out-of-sample segment equals to the walk-forward step 

Based on these two assumptions the “EASY” mode takes in-sample END date and sets out-of-sample 
START date to the following day. Then adds in-sample STEP and this becomes out-of-sample END 
date. 

In-sample and Out-of-sample step values are set to the same values. The “EASY” mode guarantees 
correctness of WF procedure settings. 
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You should use Easy mode (EOD) when testing on end-of-day data or Easy mode (Intraday) when 
testing on intraday data. The difference is that in EOD mode the END date of previous period and 
START date of next period are the same - thus avoiding gap 

between periods. Intraday mode set START date of the next period as NEXT DAY after END of 
previous period. That guarantees 

that boundary day is not counted twice when testing on intraday data. 

In the Advanced mode, the user has complete control over all values, to the extent that they may not 
constitute valid WF procedure. 

The interface allows to selectivelly disable in-sample and out-of-sample phases using checkboxes at 
top (for special things like running sequential backtests without optimization). 

All settings are immediatelly reflected in the PREVIEW list that shows all generated IS/OOS segments 
and their dates. 

4. The “Optimization target” field defines the optimization raport COLUMN NAME that 

will be used for sorting results and finding the BEST one. Any built-in column can be used 
(as appears in the optimization output), or you can use any custom metric that you define 
in custom backtester. The default is CAR/MDD, you can however select any other built-in metric from 
the combo. 

You can also TYPE-IN any custom metric that you have added via custom backtester interface. 

5. Once you defined Walk-Forward settings, please go to Automatic Analysis and 

6. press the dropdown ARROW on the Optimize button and select “Walk Forward Optimization” 

This will run sequence of optimizaitons and backtest and the results will be displayed in the “Walk 
Forward” document that is open in the main application frame. When optimization is running you can 
click “MINIMIZE” button on the Progress dialog to minimize it - this allows to see the Walk Forward 
output during the optimization steps. 

IN-SAMPLE and OUT-OF-SAMPLE combined equity 

Combined in-sample and out-sample equities are available by —ISEOUITY and —OSEOUITY composite 
tickers (consecutive periods of IS and OOS are concatenated and scaled to maintain continuity of equity line - 
this approach assumes that you generally speaking are compounding profits). 

To display IS and OOS equity you may use for example this: 

PlotForeign ("~~~ISEQUITY"In-Sample Equity", colorRed, styleLine); 

PlotForeign ( "-OSEQUITY" , "Out-Of-Sample Equity", colorGreen, styleLine); 

Title = "{{NAME}} - {{INTERVAL}} {{DATE}} {{VALUES}}"; 

OUT-OF-SAMPLE summary report (new in 5.60) 

Version 5.60 brings a new walk-forward summary report that covers all out-of-sample steps. It is visible in the 
Report Explorer as last one and has "PS" type. 

There were significant changes to walk forward testing made to allow summary out-of-sample report. The 
most important change is that each subsequent out-of-sample test uses initial equity equal to previous step 
ending equity. (Previously it used constant initial equity). This change is required for proper calculation of all 
statistics/metrics throughout all sections of out-of-sample test. 

Summary report shows the note that built-in metrics correctly represent all out-of-sample steps but summary 
custom metrics are composed using user-definable method: 

1 first step value, 2 last step value, 3 sum, 4 average, 5 minimum, 6 maximum. 
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By default summary report shows last step value of custom metrics UNLESS user specifies different 
combining method In 
bo.AddCustomMetrIcsO call. 

bo.AddCustomMetrIcs has now new optional parameter - ComblneMethod 

bool AddCustomMetrlc( string Title, variant Value, [optional] variant LongOnlyValue, [optional] variant 
ShortOnlyValue , [optional] variant DecPIaces = 2, [optional] variant ComblneMethod = 2 ) 

This method adds custom metric to the backtest report, backtest "summary" and optimization result list. Title 
Is a name of the metric to be displayed In the report. Value Is the value of the metric, optional arguments 
LongOnlyValue, ShortOnlyValue allow to provide values for additional long/short-only columns In the backtest 
report. Last argument DecPIaces controls how many decimal places should be used to display the value. 

Supported ComblneMethod values are: 

1 first step value, - summary report will show the value of custom metric from very first out-of-sample step 

2 last step value (default), - summary report will show the value of custom metric from the last out-of-sample 
step 

3 sum, - summary report will show the sum of the values of custom metric from all out of sample steps 

4 average, - summary report will show the average of the values of custom metric from all out of sample steps 

5 minimum, - summary report will show the smallest value of custom metric from all out of sample steps 

6 maximum.- summary report will show the largest value of custom metric from all out of sample steps 

Note that certain metrics calculation methods are complex and for example averaging them would not lead to 
mathematically correct representation of all out of sample test. Summaries of all bullt-ln metrics are 
mathematically correct out-of-the-box (I.e. they are *not* averages, but properly calculated metrics using 
method that Is appropriate for given value). This contrasts with custom metrics, because they are 
user-definable and It Is up to the user to select 'combining' method, and still It may happen that none of the 
available methods Is appropriate. 

For that reason the report Includes the note that explains what user-definable method was used to combine 
custom metrics. 
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Back-testing systems for futures contracts 

Introduction 

Before you read this article you should read first "Backtesting your trading ideas" section as it gives necessary 
background of backtesting in general. 

When you open long position on stocks you just buy given number of shares at given price, then after some 
time you sell them and your profit is given by difference between sell and buy price mutliplied by number of 
shares. If you want to open long position on future contract you pay a deposit - margin - for each contract. The 
margin is just a little part of full contract value (for example 10%). So you can buy 10 contracts paying no 
more than full value of one contract. This gives you a leverage that makes trading futures more risky than 
trading stocks. When price of the contract changes your profit/loss changes accordingly. If contract's point 
value is 1 each 1$ change in contract price represents 1$ profit/loss per contract - like in stocks. But futures 
can have point value different that 1. If, for example, point value is 5 each 1 point change in price of the 
contract represents 5$ profit/loss in your equity. When you close position you get the margin deposit back, so 
your profit/loss is given by number of contracts multiplied by point value mutlipled by difference between sell 
and buy prices. 

Futures mode of the backtester 

There are 3 futures-only settings in the backtester: 

• Futures mode check box (Settings-General page) 

• Margin deposit (Symbol-Information page) 

• Point value (Symbol-Information page) 



Futures mode check box in the settings page (underscored with green line in the picture above) is the key to 
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backtesting futures. It instructs backtester to use margin deposit and point vaiue in caicuiations. 
The remaining settings are per-symboi and they are accessibie from Symboi->lnformation window. 



Margin deposit 

The margin is the amount of money required to open singie contract position. You can specify per-symboi 
margin in the Symboi-Information page (picture above). Positive values describe margin value in dollars, while 
negative express margin value as percentage of contract price. Margin value of zero is used for stocks (no 
margin). Margin can be also specified in the formula by using MarginDeposit reserved variable: 

MarginDeposit = 675; 

In the Futures mode margin setting is used to determine how many contacts can be purchased. Let's suppose 
that your initial equity is set to $50000 and you want to invest upto 20% of equity in single trade and the 
margin deposit is $675. In that case your "desired" position size is 50'000 * 0.2 = lO'OOO. Provided that you 
have set round lot size to 1, the backtester will "buy" 10000/675 = (integer)14.8148 = 14 contracts, and true 
positon value will be $9450 (18.9% of the initial equity). 

To simulate this in AmiBroker you would need to enter 50000 in the Initial Equity field in the backtester, switch 
on futures mode, and setup remaining parameters in your formula: 

PositionSize = -20; // use 20% of equity 
MarginDeposit = 675; // this you can set also in the 
Symbol-Information page 

RoundLotSize =1; // this you can set also in the Settings page 

All further trades will use the same logic but position will be sized according to current cumulated equity 
instead of initial equity level, unless you specify fixed position size in your formula ( PositionSize = 10000 for 
example). 

Point value 
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Point-value is per-symbol setting (definable in Symbol-Information window - (picture above)) that determines 
the amount of profit generated by one contract for a one point increase in price. Example: copper is quoted in 
cents per pound, a price quote of 84.65 (or 8465) equals 84 cents and 65/100 of a cent per pound. A change 
of -I-.37 or 37 represents 37/100ths of a cent you will normally hear it quoted as 37 points. But because of the 
fact that point value for copper is 2.5 every point change gives $2.5 profit/loss, so in this example profit/loss 
for the day would be 2.5 * 37 = $92.50. 

You can also set it from the formula level using PointValue reserved variable, for example: 

PointValue = 2.5; 

Note: When you load old database AmiBroker presets point value field to 1 and assumes that by default 1 
point represents one dollar so one dollar change gives one dollar profit/loss. This is done to ensure that you 
get correct results even if you (by mistake) run futures mode test on stocks. 

Note 2: Although point value setting affects (multiplies) profits/losses it does NOT affect built-in stops. The 
stops ALWAYS operate on price movement alone. So you should be aware that setting 10% profit target stop 
will result in 25% profit on trade exited by this stop when point value is set to 2.5. 

Simple cases 

Points-only test 

Points only test is equivalent to trading just one contract. This can be easily accomplished using Futures 
mode of the backtester and adding the following one line to your formula: 

PositionSize = MarginDeposit = 1; 

Trading 'n' contracts 

In a similar way you can setup your formula so it always trades say 7 contracts. All you need to do is to add 
the following to your formula: 

NumContracts = 7; 

PositionSize = NumContracts * MarginDeposit; 
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Monte Carlo Simulation of your trading system 

NOTE: Advanced topic. Make sure to read previous parts of the tutorial first. 

Introduction 

Generally speaking "Monte Carlo" methods represent broad class of computer algorithms that use repeated 
random sampling to obtain statistical properties of given process. It was Invented by Polish mathematican 
Stanislaw Ulam working on nuclear weapons projects at the Los Alamos lab. As he was unable to analyse 
complex physical processes using conventional mathematical methods, he thought that he could set up a 
series of random experiments, observe the outcomes and use them to derive statistical properties of the 
process. 

More on Monte Carlo methods In general can be found here: 
https://en.wlklpedla.org/wlkl/Monte_Carlo_method 

In trading system development, Monte Carlo simulation refers to process of using randomized simulated trade 
sequences to evaluate statistical properties of a trading system. 

There are many ways to perform actual computations that differ when It comes to Implementation details, but 
probably the most straightforward and reliable Is bootstraping method that performs random sampling with 
replacement of actual trade list generated by the back-test. 

See https://en.wlklpedla.org/wlkl/Bootstrapplng_(statlstlcs) for detailed discussion of bootstrapping method. 

Various Monte Carlo simulation methods allow to verify robustness of the trading system, find out probability 
of ruin and many other statistical properties of the trading system. 

How does it work in AmiBroker? 

In order to perform Monte Carlo simulation (or bootstrap test) of your trading system, AmiBroker performs the 
following: 

A. Creating Input set 

A. 1 Perform back-testing of your trading system to produce original set of /V trades 

B. Repeatedly (lOOO-r times) 

B. 1 pick randomly trades from the original trade list to produce new, random set of /V trades 
(called 'realization') 

This random set contains the same number of trades, they are ordered randomly and some 
original trades may be skipped and some used more than once (permutation with repetition, 
or random sampling with replacement). 

Since number of unique realizations Is N^N (so with just 100 Input trades we have 10000 
unique realizations), with sufficient number of trades (>100) the probability of picking Identical 
sequence as original Is virtually zero. 
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B.2 perform gain/loss calculation for each randomly picked trade, using position sizing 
defined by the user to produce system equity 

B. 3 record system equity in the distribution 
C. Post-process 

C. 1 Process data obtained in B to generate distribution statistics and charts 

All of the above happens when you press Backtest button in the New Analysis window. AmiBroker's Monte 
Carlo simulator is so fast that it usually costs just a fraction of second on top of normal backtest procedure. 

Settings 

The way how Monte Carlo simulator works can be controlled from the Analysis Settings page, "Monte Carlo" 
tab: 



Enable Monte Carlo simulation 


this check box controls whenever MC simulation is performed automatically as a part of backtest (right after 
backtest generates trade list) 

Number of runs 

defines the number of MC simulations to run (should be 1000 or more) 
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Position sizing 

defines position sizing method used by MC simuiator: 

Don't change - uses original position size as used during backtest 
Fixed size - uses fixed number of shares/contracts per trade 
Constant value - uses fixed dollar amount for opening any trade 
Percent of equity - uses defined percent of current simulated equity value 
Enable MC equity curves (Mln/Max/Avg) 

turns on MC equity charts (including highest, lowest and average equity plots plus straw broom equity charts). 
Note that green and red lines (min/max equity) are not really single "best" and "worst" equities. They are 
bar-by-bar highest (max) and lowest( min) points of ALL equities generated during MC. 

So they are actually best points from all equities and worst points from all equities. And blue line (avg) is the 
average from all equity lines (all runs). 

Show absolute value - displays equities in absolute dollar values 

Show Percent change - displays equities as "rate of change" since the beginning 

Straw broom chart plots - defines how many individual test equites should be plotted as 'straw 
broom chart' (large number may slow down processing/drawing) 

Interpreting the results 

The results of Monte Carlo simulation are displayed in the "Monte Carlo" page of Backtest report. 

At the top of the page we can see a table that gives values of few key statistics derived from the distribution of 
Monte Carlo simulation results. 

Here are sample results (highlights are added manually for the purpose of illustration). Starting equity was 
10000 in this example. Test was done over 7 years (EOD data). 



Final Equity 

Annual Return 

Max. Drawdown $ 

Max. Drawdown % 

Lowest Eq. 

1% 

5706 

-7.37% 

1302 

7.23% 

3618 

5% 

7987 

-3.02% 

1549 

9.76% 

5853 

10% 

9706 

-0.41% 

1726 

11.32% 

6690 

25% 

12851 

3.48% 

2136 

14.38% 

8107 

50% 

16174 

6.78% 

2747 

19.77% 

9135 

75% 

19632 

9.64% 

3563 

27.63% 

9640 

90% 

23258 

12.21% 

4626 

38.48% 

9922 

95% 

25269 

13.48% 

5292 

45.47% 

10000 

99% 

29139 

15.71% 

7685 

63.82% 

10000 


First column shows percentile level (the value below which a given percentage of test observations 
(realizations) fall). So say 10th percentile tells us that 10% of time observed value is below shown amount. 
For example, the annual return value at 10th pecentile (in this case -0.41%) means that 10% of tests 
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(realizations) had annual profit less or equal than shown (-0.41%). So we can say that there is about 10% 
chance that our system would not make any money (would not breakeven). A max. drawdown figure at 90th 
percentile (38.48%) means that in 90% of cases drawdown will be less than 38.48%. So in other words, we 
can say that there is 10% of chance that it will be higher than that. If we look further in the table we can also 
notice that in 99% of cases drawdown will be less than 63.82% 

Below the table we can find min/avg/max -i- straw broom chart of simulated equities: 


35000 

30000 

25000 

20000 


15000 

10000 

5000 


Note that green and red lines (min/max equity) are not really single "best" and "worst" equities. They are 
bar-by-bar highest (max) and lowest( min) points of ALL equities generated during MC. So they are actually 
best points from all equities and worst points from all equities. And blue line (avg) is the average from all 
equity lines (all runs). The 'cloud' of gray lines represents individual test equities - as we can see the same 
trading system may generate different outcomes when market conditions change and MC simulation attempts 
to simulate various outcomes and provide you some statistical information on how bad/good it may be. 

After straw broom chart you can find cumulative distribution function (CDF) charts of final equity, CAR, 
drawdowns and lowest equity (again green and red annotation lines were added manually): 




15% 

10 % 

5% 

0 % 


-5% 


- 10 % 


Cumulative distribution charts presents the same information that was included in the table at the top of 
"Monte Carlo" page but in the graphical form. Again, when we take a look at annual profit % (CAR) distribution 
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chart we can see that in approximately 10% of cases our system would not break even (produces negative 
CAR). We can also see that in approximately 35% of cases our CAR would be below 5%. Profits above 10% 
per year only occur in top 20% of tests. 

All other charts in the MC page are constructed the same and you can read them using the same 
methodology. 

Final equity chart shows the cumulative distribution function of final value of the equity (at the end of test 
period) 

Annual return chart shows the cumulative distribution function of compound annual percentage return of the 
test 

Max. Drawdown $ and Max. Drawdown % charts show the cumulative distribution function of drawdowns 
(maximum peak to valey dollar/percent distances) experienced during the test 

Lowest Equity chart shows the cumulative distribution function of lowest equity ever experienced during the 
test 

How to control it from the formula level? 

In addition to using Settings dialog, you can control Monte Carlo simulator using SetOption() function. You can 
also retrieve those values using GetOption function. 

SetOption("MCEnable", 0 ); // value == 0 disables MC simulation 

SetOption("MCEnable", 1 ); //value == 1 enables MC only in portfolio backtests (default) 

SetOption( "MCEnable", 2 ); // value == 2 forces MC to be enabled everywhere (in every mode including 
optimization - SLOW !) 

Note that enabling MC in optimization is highly discouraged unless you actually use MC metrics as 
optimization target via custom backtester 

or otherwise use MC distributions in the optimization process. Monte Carlo process is computationally costly 
and while few hundred milliseconds added to one backtest don't matter much, in case of optimizations when 
these are multipled by number of steps you can easily increase optimization time by orders of magnitude. So 
unless you REALLY need MC distribution as custom metric and optimization target, do NOT enable MC in 
optimization. 

SetOption("MCRuns", 1000 ); // define number of MC simulation runs (realizations) 

Other MC parameters that can be set using SetOption and retrived using GetOption: 

• "MCChartEquityCurves" (true/false) 

• "MCStrawBroomLines" (0..100) 

• "MCPosSizePctEquity" (0..100) 

• "MCPosSizeMethod" - 0 - don't change, 1 - fixed size, 2 - constant amount, 3 - percent of equity, 

• "MCPosSizeShares" (number), 

• "MCPosSizeValue" (number) 

• "MCPosSizePctEquity" (number) 


How to add custom metric based on MC test distribution(s) to the backtest report ? 
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In addition to buiit-in MC report, you can add your own custom metrics to the report using 
GetMonteCarioSimO method of the Backtester object and MonteCarioSim object that this function returns. If 
you are new to custom metrics, piease consuit "How to add custom metrics to backtester report" part of this 
manuai first. 

MonteCarioSim object has one function GetVaiue( "fieid", percentile ) that allows to access CDF values. 
Available "field" values are: 

• "FinalEquity" 

• "CAR" 

• "LowestEquity" 

• "MaxDrawdown" 

• "MaxPercDrawdown" 

Now here is the sample code that presents how to add 30th percentile FinalEquity and CAR to the report: 

SetOption( "MCEnable", True ); 

SetOption( "MCRuns", 1000 ) ; 

SetCustomBacktestProc ( "" ) ; 

if ( Status ( "action" ) == actionPortfolio ) 

{ 

bo = GetBacktesterObjectO; 

bo.Backtest 0; // run default backtest procedure 

// get access to Monte Carlo results 

// note 1: it may be NULL if MC is NOT enabled 

// note 2: MC results are available after Backtest() or PostProcess 
// as MC simulation is done in final phase of post processing 
me = bo.GetMonteCarloSim(); 

if ( me ) 

{ 

// get 30-th percentile of final equity and CAR distribution 

bo.AddCustomMetric( "FinalEqSO", mc.GetValue( "FinalEquity", 30 ) ); 

bo.AddCustomMetric( "CAR30", mc.GetValue( "CAR", 30 ) ); 

// you can also combine MC stats with normal stats 
St = bo.GetPerformanceStats( 0 ) ; 

bo.AddCustomMetric( "CAR30/MDD", mc.GetValue( "CAR", 30 ) / st.GetValue( 

"MaxSystemDrawdownPercent" ) ) ; 

} 

} 

Once custom metrics is added, it can be used as Optimization target (don't forget to change MCEnable to 2) 
and used in Walk Forward test process as objective function. To select custom metric as optimization target, 
you would need to type its name exactly as it appears in the AddCustomMetric call into "Optimization Target" 
field in the Settings dialog. Walk Forward page. This way you can run optimization / walk forward test that is 
directed by values of MC simulation distribution. So for example instead of using CAR/MDD you can use 
CAR30/MDD (30th percentile MC CAR divided by max. system drawdown). 
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How about Monte Carlo randomization instead of bootstrap test? 

The Monte Carlo randomization is different than bootstrap test because it does not use actual (realized) trade 
list from the backtest but it attempts to use "all individual returns whenever they are realized or hyphotetical". 
For example when trading system is generating way more signals than we can actually trade due to limited 
buying power, then we have to choose which trades we would take and which we would skip. Normally this 
selection is a part of trading system and in AmiBroker PositionScore variable tells the backtester which 
positions are preferred and should be traded. In randomization test, instead of using some 
analytic/deterministic PositionScore, you use random one. If there are more signals to open positions than we 
could take, this process would lead to randomized trade picks. Now using Optimize() function and random 
PositionScore we can run thousands of such random picks to produce Monte Carlo randomization test: 

step = Optimize ( "step", 1, 1, 1000, 1 ); // 1000 backtests 

// with random trade picks from the broad universe (make sure you run it on large 
watch lists) 

PositionScore = mtRandomO; 

Randomization test has one big disadvantage: can not be used in many cases. When system does not 
produce enough signals each bar there is not much (if any) to choose from. Also, more importantly, MC 
randomization makes false assumption that all "trading opportunities" (signals) are equal. In many cases they 
are not. Pretty often our trading system has specific, deterministic way to pick trades from many oppotunities 
by some sort of ranking/scoring. When system is using a score (rank) as a core component of the system 
(rotational systems do that) - if you replace analytic score of with random number you are just testing white 
noise not the system. 
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Pyramiding (scaling in/out) and mutliple currencies in the portfolio 
backtester 

IMPORTANT: Please read first Tutorial: Backtesting your trading ideas article and Portfolio 
Backtesting 

Starting from version 4.70 portfolio backtester allows position scaling and supports multiple currencies. Note 
that these advanced features are supported by PORTFOLIO backtester only. Old single-security backtester 
and single-security equityQ function do NOT support these features. 

Pyramiding / Scaling 

Two special constants: sigScaleIn / sigScaleOut added to provide means to tell the backtester when you want 
to scale-in/out 

All you have to do to implement pyraminding is to: 

- Assign sigScaleIn to BUY/SHORT variable if you want to scale-in (increase size of) LONG/SHORT position 

- Assign sigScaleOut to BUY/SHORT variable if you want to scale-out (decrease size of) LONG/SHORT 
position 

Scaling size is defined by PositionSize variable which in case of scaling defines not absolute positionsize but 
dollar increase or decrease. 

IMPORTANT: Please note that backtester treats trade that you scale-in/out as SINGLE trade (i.e. will show 
single row in trade list). The only difference versus plain trade is that it will calculate average entry price (and 
avg. entry fx rate) based on all partial entries and average exit price (and avg. exit fx rate) based on all parial 
exits and will show average prices in entry/exit price field. The commission is of course applied correctly to 
each (partial) entry/exit depending on partial buy/sell size. 

If you want to see details about scaling you have to run backtest in "DETAIL LOG" mode as only then you will 
see how scaling-in /out works and how average prices are calculated. 

Note also that scaling-in/-out and multiple-currency support is available only in portfolio backtester. Old 
backtester as well as EquityQ function do NOT handle scaling-in/out nor multiple currencies (they simply 
ignore scaling commands). 

Easy examples: 

Example 1: dollar-cost averaging (each month you buy stocks for fixed dollar amount) 


FixedDollarAmount = 500; 

MonthBegin = Month () != Ref ( Month (), -1 ) ; 

FirstPurchase = Cum ( MonthBegin ) == 1; 

Buy = IIf( FirstPurchase, 1 , // True (or 1) represents regular buy signal 
Ilf ( MonthBegin, sigScaleIn, // each month increase position 
0 ) ); // otherwise no signal 

Sell = 0; // we do not sell 
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PositionSize = FixedDollarAmount; 

Example 2: dollar-cost averaging 

(simplified formula because AB treats first sigScaleIn as buy anyway) 

FixedDollarAmount = 500; 

MonthBegin = Month () != Ref ( Month (), -1 ); 

FirstPurchase = Cum ( MonthBegin ) == 1; 

Buy = IIf( MonthBegin, sigScaleIn, 0 ) ; // each month increase position 
Sell = 0; // we do not sell 
PositionSize = FixedDollarAmount; 


Example 3: increasing position when profit generated by trade without pyramiding 
becomes greater than 5% and decreasing position when loss is greater than -5% 

// percent equity change threshold when pyramiding is performed 
PyramidThreshold = 5; 

// regular trading rules (no pyramiding) 

Buy = Cross ( MACD (), Signal () ); 

Sell = Cross ( Signal (), MACD () ); 

e = Equity (1); // generate equity without pyramiding effect 
PcntProfit = 100 * ( e - ValueWhen ( Buy, e ) ) /ValueWhen ( Buy, e ); 

InXrade = Flip( Buy, Sell ); 

// ExRem is used here to ensure that scaling-in/out occurs 
// only once since trade entry 

DoScaleIn = ExRem ( InTrade AND PcntProfit > PyramidThreshold, Sell ); 
DoScaleOut = ExRem ( InTrade AND PcntProfit < -PyramidThreshold, Sell ); 

// modify rules to handle pyramiding 

Buy = Buy + sigScaleIn * DoScaleIn + sigScaleOut * DoScaleOut; 

PositionSize = IIf( DoScaleOut, 500, 1000 ); // enter and scale-in size $1000, 
scale-out size; $500 


Example 4: partial exit (scaling out) on profit target stops 

Example of code that exits 50% on first profit target, 50% on next profit target and everything at trailing stop: 
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Buy = Cross ( MA( C, 10 ), MA( C, 50 ) ); 

Sell = 0; 

// the system will exit 

// 50% of position if FIRST PROFIT TARGET stop is hit 
// 50% of position is SECOND PROFIT TARGET stop is hit 
// 100% of position if TRAILING STOP is hit 

FirstProfitTarget = 10; // profit 
SecondProfitTarget = 20; // in percent 
TrailingStop = 10; // also in percent 

priceatbuy=0; 
highsincebuy = 0; 

exit = 0; 

for ( i = 0; i < BarCount; i++ ) 

{ 

if ( priceatbuy == 0 AND Buy [ i ] ) 

{ 

priceatbuy = BuyPrice [ i ]; 

} 

if ( priceatbuy > 0 ) 

{ 

highsincebuy = Max ( High [ i ], highsincebuy ); 
if ( exit == 0 AND 

High [ i ] >= ( 1 + FirstProfitTarget * 0.01 ) * priceatbuy ) 

{ 

// first profit target hit - scale-out 
exit = 1; 

Buy[ i ] = sigScaleOut; 

} 

if ( exit == 1 AND 

High [ i ] >= ( 1 + SecondProfitTarget * 0.01 ) * priceatbuy ) 

{ 

// second profit target hit - exit 
exit = 2; 

SellPrice [ i ] = Max ( Open [ i ], ( 1 + SecondProfitTarget * 0.01 ) * 

priceatbuy ); 

} 

if ( Low [ i ] <= ( 1 - TrailingStop * 0.01 ) * highsincebuy ) 

{ 

// trailing stop hit - exit 
exit = 3; 

SellPrice [ i ] = Min ( Open [ i ], ( 1 - TrailingStop * 0.01 ) * 

highsincebuy ); 

} 
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if ( exit >= 2 


Buy[ i ] = 0; 

Sell [ i ] = exit +1; // mark appropriate exit code 
exit = 0; 

priceatbuy = 0; // reset price 
highsincebuy = 0; 


SetPositionSize ( 50, 
SetPositionSize ( 50, 
out 50% of position 


spsPercentOfEquity ) ; 
spsPercentOfPosition * 


Buy 


sigScaleOut 


// scale 


Mulitple Currency Support 


The portfolio backtester allows to backtest systems on securites denominated in different currencies. It 
includes ability to use historical (variable) currency rates. Currency rates are definable in "Currencies" page in 
the preferences. The currency in which given symbol is denominated in can be entered in 
Symbol->lnformation page. 

"Currencies" page in Preferences - allows to define base currency and exchange rates (fixed or dynamic) 
for different currencies. This allows to get correct backtest results when testing securities denominated in 
different currency than your base portfolio currency. 

How does AB know whether I want the fixed or dynamic quote? 

There are following requirements to use currency adjustements: 

a) Symbol->lnformation, "Currency" field shows currency different than BASE currency 

b) Appropriate currency (defined in Symbol) has matching entry in Preferences->Currencies page 

c) the dynamic rate "FX SYMBOL" defined in the preferences EXISTS in your database and HAS QUOTES 
for each day under analysis range. 

What is "INVERSE" check box for in the preferences? 

Let's for example take EURUSD. 

When "USD" is your BASE currency then EUR exchange rate would be "straight" EURUSD fx (i.e. 1.3). 

But when "EUR" is your BASE currency then USD exchange rate would be INVERSE of EURUSD (i.e. 1/1.3). 
Opposite would be true with FX rates like USDJPY (which are already "inverse"). 
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Using formula-based alerts 

Introduction 

AmiBroker allows you to define formula-based alerts. When alert is triggered a text can be displayed, 
user-defined sound played back, e-mail notification can be sent and any external application can be launched. 
This is all handled by single AlertIF function. 

By default all alerts generate text that is displayed in the Alert Output window. 

To show this window you have to select Window->Alert Output menu. 

There is also Easy Alerts window that allows you to define simple alerts that do not require any coding (but do 
not offer full flexibility of Alertif function). 

Settings 

Alert - related settings are present in the "Alerts" tab of Tools->Preferences window. 

It allows to define e-mail account settings, test sound output and define which parts of AmiBroker can 
generate alerts via AlertIF function. 

E-mail setting page now allows to choose among most popular authorization schemes like: AUTH LOGIN 
(most popular), POP3-before-SMPT (popular), CRAM-MD5, LOGIN PLAIN. 

"Enable alerts from" checkboxes allow you to selectively enable/disable alerts generated by Automatic 
analysis, Commentary/Interpretation and custom indicators. 

Alert output window now has an additional column that shows the source of alert - if this is Automatic 
Analysis, Commentary or one of your custom indicators. This makes it easier to find out which part of 
AmiBroker generates alerts. 

New in AmiBroker 5.30 - support for SSL (secure connection) used by GMail for example. 

In order to enable SSL support you need to follow these steps: 

1. Download and run SSL add-on from http://www.amibroker.com/bin/SSLAddOn.exe 

2. Configure (Tools->Preferences->Alerts) with SSL enabled as shown below 
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AlertIF function 

AlertIF function is simiiar to WritelF. But instead of just writing the text to the output window 
(commentary/interpretation) it aiiows to: 

• direct the customized text to "aiert output" window, 

• make a sound (just by computer beeper or from .WAV fiie) 

• send an e-maii 

• iaunch any externai appiication 

The syntax is as foiiows: 

Aiertlf( BOOLEAN EXPRESSION, command, text, type= 0, flags = 1+2+4+8, lookback = 1 ); 

1. BOOLEAN EXPRESSION is the expression that if evaiuates to True (non zero vaiue) triggers the aiert. If it 
evaluates to False (zero value) no alert is triggered. Please note that only lookback most recent bars are 
considered. 

2. The command string defines the action taken when alert is triggered. If it is empty the alert text is simply 
displayed in the Alert output window (Window->Alert Output). Other supported values of command string are: 

SOUND the-path-to-the-WAV-flle 
EMAIL 

EXEC the-path-to-the-flle-or-URL <optlonal args> 
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SOUND command plays the WAV file once. 

EMAIL command sends the e-mail to the account defined in the settings (Tools->Preferences->E-mail). The 
format of the e-mail is as follows: 

Subject: Alert type_name (type) Ticker on Date/Time 
Body: text 

EXEC command launches external application or file or URL specified after EXEC command. <optional args> 
are attached after file name and fexf is attached at the end 

3. Text defines the text that will be printed in the output window or sent via e-mail or added as argument to the 
application specified by EXEC command 

4. Type defines type of the alert. Pre-defined types are 0 - default, 1 - buy, 2 - sell, 3 - short, 4- cover. YOu 
may specify higher values and they will get name "other" 

5. Flags control behaviour of AlertIF function. This field is a combination (sum) of the following values: 

(1 - display text in the output window, 2 - make a beep (via computer speaker), 4 - don't display repeated 
alerts having the same type, 8 - don't display repeated alerts having the same date/time) By default all these 
options are turned ON. 

6. tookback parameter controls how many recent bars are checked 
Examples: 

Buy = Cross( MACD(), Signal() ) ; 

Sell = Cross( Signal(), MACD() ); 

Short = Sell; 

Cover = Buy; 

AlertIF( Buy, "EMAIL", "A sample alert on "+FullName(), 1 ); 

AlertIF( Sell, "SOUND C:\\Windows\\Media\\Ding.wav", "Audio alert", 2 ); 

AlertIF( Short, "EXEC Calc.exe", "Launching external application", 3 ); 

AlertIF( Cover, "Simple text alert", 4 ); 

Note EXEC command uses ShellExecute function and allows not only EXE files but URLs too. 

Notes 

1. Please note that by default Alertif function does not generate repetitive signals when the same scan is run 
multiple times. During experimentation you may prefer to get repeated signals in subsequent scans. To do so 
you should change default flags to 1 -i- 2: 

AlertIF( condition, "Text", 1, 1+2 ); 

2. If you want to generate the alert only on COMPLETED bar you may need to add this code: 


barcomplete = BarIndexO < LastValue(Barindex()); 
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AlertIF( barcomplete AND condition, "Text", 1 ) ; 


Using formula-based alerts 


259 



AmiBroker 6.00 User's Guide 


Tutorial 


Using interpretation window 

Note: Please read How to write your own chart commentary article before proceeding. 

Interpretation window (Window->lnterpretation) shows chart-sensitive commentaries. To add a interpretation 
just use Formula Editor and add commentary code after the code for the indicator. Please note that to get the 
best performance you should use conditional statement that ensures that interpretation code is executed only 
in "commentary" mode. 

if ( Status ( "action" ) == actionCommentary ) 

{ 

// printf statements here.... 

} 

Example: 

Plot ( Close, "Price", -1, 64 ) ; 

Plot( SAR( Prefs ( 50 ), Prefs ( 51 ) ), "SAR",-17, 8+16 ); 

if ( Status ( "action" ) == actionCoininentary ) 

{ 

printf ("The Parabolic SAR provides excellent exit points. \n"); 
printf ("You should Close long positions when the price falls belowXn"); 
printf ("the SAR AND Close Short positions when the price rises above the 
SAR. \n") ; 

printf ( Writelf ( Graphl > Close, "SAR is above close", "SAR is below close" ) ); 

} 
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Multiple Time Frame support in AFL 

Release 4.41 brings ability to use multiple time frames (bar intervals) in single formula. The time frame 
functions can be divided into 3 functional groups: 

1. switching time frame of build-in O, H, L, C, V, 01, Avg arrays: TimeFrameSet, TimeFrameRestore 

2. compressing/expanding single arrays to/from specified interval: TimeFrameCompress, 
TimeFrameExpand 

3. immediate access to price/volume arrays in different time frame: TimeFrameGetPrice 

First group is used when your formula needs to perform some calculations on indicators in different time 
frame than currently selected one. For example if you need to calculate 13-bar moving average on 5 minute 
data and 9 bar exponential avarage from hourly data while current interval is 1 minute you would write: 

TimeFrameSet ( inSMinute ); // switch to 5 minute frame 

/* MA now operates on 5 minute data, ma5_13 holds time-compressed 13 bar MA of 
5mln bars */ 

ma5_13 = MA( C, 13 ); 

TimeFrameRestore 0; // restore time frame to original 

TimeFrameSet ( inHourly ) ; // switch now to hourly 

mah_9 = EMA ( C, 9 ); // 9 bar moving average from hourly data 

TimeFrameRestore 0; // restore time frame to original 

Plot ( Close, "Price", colorWhite, styleCandle ); 

// plot expanded average 

Plot ( TimeFrameExpand ( ma5_13, inSMinute), "13 bar moving average from 5 min 

bars", colorRed ); 

Plot ( TimeFrameExpand ( mah_9, inHourly), "9 bar moving average from hourly bars", 

colorRed ); 

TimeFrameSet( interval ) - replaces current built-in price/volume arrays: open, high, low, close, volume, 
openint, avg with time-compressed bars of specified interval once you switched to a different time frame all 
calculations and built-in indicators operate on selected time frame. To get back to original interval call 
TimeFrameRestoreO funciton. If you want to call TimeFrameSet again with different interval you have to 
restore original time frame first using TimeFrameRestore(). Interval is time frame interval in seconds. For 
example: 60 is one minute bar. You should use convenient constants for common intervals: ini Minute, 
inSMinute, inISMinute, inHourly, inDaily, inWeekly, inMonthly. 

With version 4.70 you can also specify N-tick intervals. This is done by passing NEGATIVE value as interval. 
For example -5 will give 5-tick bar compression, and -133 will give 133-tick compression. Please note that 
using N-tick intervals works only if your database uses Tick base time interval set in File -> Database 
Settings dialog. 
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TimeFrameSet ( -133 ); // switch to 133-tick interval 

TimeFrameRestoreO - restores price arrays replaced by SetTimeFrame.Note that only OHLC, V, 01 and Avg 
built-in variables are restored to original time frame when you call TimeFrameRestore(). All other variables 
created when being in different time frame remain compressed. To de-compress them to original interval you 
have to use TimeFrameExpand. 

Once you switch the time frame using TimeFrameSet, all AFL functions operate on this time frame until you 
switch back the time frame to original interval using TimeFrameRestore or set to different interval again using 
TimeFrameSet. It is good idea to ALWAYS call TimeFrameRestore when you are done with processing in 
other time frames. 

When time frame is switched to other than original interval the results of all functions called since 
TimeFrameSet are time-compressed too. If you want to display them in original time frame you would need to 
'expand' them as described later. Variables created and assigned before call to TimeFrameSet() remain in the 
time frame they were created. This behaviour allows mixing unlimited different time frames in single formula. 

Please note that you can only compress data from shorter interval to longer interval. So when working with 
1-minute data you can compress to 2, 3, 4, 5, 6, ....N-minute data. But when working with 15 minute data you 
can not get 1-minute data bars. In a similar way if you have only EOD data you can not access intraday time 
frames. 

Second group: TimeFrameCompress/TimeFrameExpand allow to compress and expand single arrays to / 
from different time frames. Especially worth mentioning is TimeFrameExpand that is used to decompress 
array variables that were created in different time frame. Decompressing is required to properly display the 
array created in different time frame. For example if you want to display weekly moving average it must be 
'expanded' so the data of one weekly bar covers five daily bars (Monday-Friday) of corresponding week. 

TimeFrameExpand( array, interval, mode = expandLast) - expands time-compressed array from 'interval' 
time frame to base time frame ('interval' must match the value used in TimeFrameCompress or 
TimeFrameSet) 

Available modes: 

expandLast - the compressed value is expanded starting from last bar within given period (so for example 
weekly close/high/low is available on Friday's bar) 

expandFirst - the compressed value is expanded starting from first bar within given period (so for example 
weekly open is available from Monday's bar) 

expandPoint - the resulting array gets not empty values only for the last bar within given period (all remaining 
bars are Null (empty)). 

Caveat: expandFirst used on price different than open may look into the future. For example if you create 
weekly FIIGFI series, expanding it to daily interval using expandFirst will enable you to know on MONDAY 
what was the high for entire week. 

TimeFrameCompress is provided for completeness and it can be used when you want to compress single 
array without affecting built-in OFILC,V arrays. If you call TimeFrameCompress it does not affect results of 
other functions. 

wc = TimeFrameCompress ( Close, inWeekly ); 

/* now the time frame is still unchanged (say dally) and our MA will operate on 
dally data */ 

dailyma = MA ( C, 14 ); 
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/* but if we call MA on compressed array. It will give MA from other time frame 
*/ 


weeklyma = MA ( wc, 14 ); // note that argument is time-compressed array 
Plot ( dailyma, "DailyMA", colorRed ) ; 

weeklyma = TimeFrameExpand ( weeklyma, inWeekly ); // expand for display 
Plot ( weeklyma, "WeeklyMA", colorBlue ) ; 

During this formuia the time frame remained at originai setting we oniy compressed singie array. 
TimeFrameCompress( array, intervai, mode = compressLast) 

- compresses singie array to given intervai using given compression mode avaiiabie modes: 
compressLast - iast (close) value of the array within interval 

compressOpen - open value of the array within interval 
compressHigh - highest value of the array within interval 
compressLow - lowest value of the array within interval 
compressVolume - sum of values of the array within interval 

GraphO = TimeFrameExpand ( TimeFrameCompress ( Close, inWeekly, compressLast ), 
inWeekly, expandLast ) ; 

Graphl = TimeFrameExpand ( TimeFrameCompress ( Open, inWeekly, compressOpen ), 
inWeekly, expandFirst ) ; 

Third group consist of just one useful function: TimeFrameGetPrice which allows to reference price and 
volume from other time frames without switching /compressing/expanding time frames. Just one function call 
to retrieve price from higher time frame. It allows also to reference not only current but past bars from different 
time frames. 

TimeFrameGetPrice( pricefield, interval, shift = 0, mode = expandFirst); 

- references OHLCV fields from other time frames. This works immediatelly without need to call 
TimeFrameSet at all. 

Price field is one of the following: "O", "H", "L", "C", "V", "I" (open interest). Interval is bar interval in seconds, 
shift allows to reference past (negative values) and future (positive values) data in higher time frame. For 
example -1 gives previous bar's data (like in Ref function but this works in higher time frame). 

Examples: 


TimeFrameGetPrice ( 

"0", 

inWeekly, 

-1 

TimeFrameGetPrice ( 

ago 

"C", 

inWeekly, 

-3 

TimeFrameGetPrice ( 

"H", 

inWeekly, 

-2 

TimeFrameGetPrice ( 

"0", 

inWeekly, 

0 

TimeFrameGetPrice ( 
intraday data 

"H", 

inDaily, 

-1 


// gives you previous week Open price 
// gives you weekly Close price 3 weeks 

// gives you weekly High price 2 weeks ago 
// gives you this week Open price. 

// gives previous Day High when working on 


Shift works as in Ref() function but it is applied to compressed time frame. 


Note these functions work like these 3 nested functions 

TimeFrameExpand( Ref( TimeFrameCompress( array, interval, compress(depending on 
field used) ), shift ), interval, expandFirst ) 
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therefore if shift = 0 compressed data may iook into the future ( weekiy high can be known on monday ). If you 
want to write a trading system using this function piease make sure to reference PAST data by using negative 
shift vaiue. 

The only difference is that TimeFrameGetPrice is 2x faster than nested Expand/Compress. 

Note on performance of TimeFrame functions: 

a) Measurements done on Athlon 1.46GHz, 18500 daily bars compressed to weekly time 
frame 

TimeFrameGetPrice( "C", inWeekly, 0 ) - 0.0098 sec (9.8 milliseconds) 

TimeFrameSet( inWeekly ) - 0.012 sec (12 milliseconds) 

TimeFrameRestore() - 0.006 sec (6 milliseconds) 

TimeFrameCompress( Close, inWeekly, compressLast); - 0.0097 sec (9.7 milliseconds) 
TimeFrameExpand( array, inWeekly, expandLast); - 0.0098 sec (9.8 milliseconds) 

b) Measurements done on Athlon 1.46GHz, 1000 daily bars compressed to weekly time 
frameall functions below 0.0007 sec (0.7 millisecond) 

How does it work internaiiy ? 

Time-frame functions do not change the BarCount - they just squeeze the arrays so you have first N-bars 
filled with NULL values and then - last part of the array contains the actual time-compressed values. This is 
why it is essential to expand the data back to the original frame with TimeFrameExpand. The following simple 
exploration shows what happens after you switch to a higher timeframe. Run Exploration on current symbol, 
all quotations, periodicity set to daily and you will see how "weekly close compressed" column contains empty 
values at the beginning and weekly compressed data at the end of array. 

Filter = 1; 

AddColumn (Close, "Daily close"); 

TimeFrameSet (inWeekly) ; 

AddColumn (wc = Close, "weekly close compressed"); 

TimeFrameRestore () ; 

AddColumn ( TimeFrameExpand (wc, inWeekly), "weekly close expanded"); 

EXAMPLES 

EXAMPLE 1: Plotting weekly MACD and cross arrows from daily data 

TimeFrameSet ( inWeekly ) ; 

m = MACD(12, 26 ); // MACD from WEEKLY data 
TimeFrameRestore () ; 

ml = TimeFrameExpand ( m, inWeekly ); 

Plot ( ml, "Weekly MACD", colorRed ); 

PlotShapes ( Cross ( ml, 0 ) * shapeUpArrow, colorGreen ); 

PlotShapes ( Cross ( 0, ml ) * shapeDownArrow, colorGreen ); 


EXAMPLE 2: weekly candlestick chart overlaid on line daily price chart 
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wo = TimeFrameGetPrice ( 

"0" 

, inWeekly, 

0, 

expandPoint 

) ; 

wh = TimeFrameGetPrice ( 

"H" 

, inWeekly, 

0, 

expandPoint 

) ; 

wl = TimeFrameGetPrice ( 

"L" 

, inWeekly, 

0, 

expandPoint 

) ; 

wc = TimeFrameGetPrice ( 

"C" 

, inWeekly, 

0, 

expandPoint 

); 

PlotOHLC ( wo, wh, wl, wc, " 
Plot ( Close, "Daily Close", 

Weekly Close 

colorBlue ) 

r 

colorWhite, 

styleCandle 


EXAMPLE 3: Simplified Triple screen system 

/* switch to weekly time frame */ 

TimeFrameSet ( inWeekly ) ; 

whist = MACD ( 12, 26 ) - Signal ( 12, 26, 9 ) ; 

wtrend = ROC ( whist, 1 ); // weekly trend - one week change of weekly macd 
histogram 

TimeFrameRestore (); 

/* expand calculated MACD to daily so we can use it with daily signals */ 
wtrend = TimeFrameExpand ( wtrend, inWeekly ) ; 


/* elder ray */ 

bullpower= High - EMA (Close, 13) ; 
bearpower= Low - EMA (Close, 13) ; 

Buy = wtrend > 0 /* 1st screen; positive weekly trend */ 

AND 

bearpower < 0 AND bearpower > Ref ( bearpower, -1 ) /* 2nd screen bear power 

negative but rising */ 

AND 

H > Ref ( H, -1 ); /* 3rd screen, if prices make a new high */ 

BuyPrice = Ref ( H, -1 ); // buy stop level; 

Sell = 0 ; // exit only by stops 

ApplyStop ( stopTypeProfit, stopModePercent, 30, True ) ; 

ApplyStop ( stopTypeTrailing, stopModePercent, 20, True ); 
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Efficient use of multithreading 

AmiBroker 5.50 fully supports multithreading (parallel execution on all CPU cores) in both charting and New 
Analysis window. This greatly enhances speed of operation and improves responsivity of application as 
worker AFL execution threads do not block the user interface. For example on 4 core Intel i7 that can run upto 
8 threads, it can run upto 8 times faster than old Analysis window. Exact speed up depends on complexity of 
the formula (the more complex it is, the more speedup is possible), amount of data processed (RAM access 
may be not as fast as CPU thus limiting possible speed gains). 

This chapter describes how to avoid pitfalls that can affect multithreaded performance. 

Understanding how multithreading is implemented 

It is important to understand one simple rule first - in AmiBroker one thread can run one operation on one 
symbols' data: 

1 operation * 1 symbol = 1 thread 

The operation is displaying single chart pane, scan, exploration, backtest, optimization. The consequences 
are as follows: single chart pane always uses one thread. Also a single backtest or optimization running on 
one symbol uses one thread only. 

But a chart that consists of 3 panes uses 3 threads, even though they all operate on the same symbol. So we 
can also write: 

N operations * 1 symbol = N threads 

We can also run single operation (like scan/exploration/backtest/optimization) on multiple symbols, then 

1 operation * N symbols = N threads 

Of course you can also run multiple Analysis windows each of it running multiple symbols or run multiple 
charts on multiple symbols, then 

P operations * N symbols = ( P * N ) threads 

It is also important to understand that some operations consist of not only AFL execution part but some extra 
processing and/or user-interface work. In such cases only AFL execution can be done with multiple threads. 
This has consequences for Individual Backtest mode which will be described in detail further. 

Note: In version 5.70 there is one exception from this rule: new multi-threaded individual optimization, that 
allows to run single-symbol optimization using multiple threads. 

Limits 

The number of threads that actually are launched depends on your CPU and the version of AmiBroker you are 
using. Standard Edition has a limit of 2 (two) threads per Analysis window. Professional Edition has a limit 
of 32 threads per Analysis window. In addition to this limit, AmiBroker will detect how many logical 
processors are reported by Windows (for example a single Intel i7 920 CPU is recognized as 8 logical 
processors (4 cores x 2 hyperthreading)) and will not run more threads per single Analysis window than the 
number of logical processors. 
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Common pitfals 

There are following areas of AFL programming that require some attention if you want to write 
multithreading-friendly AFL formulas: 

1. Avoiding the use of OLE / CreateObject 

2. Reducing use of AddToComposite / Foreign to minimum 

3. Efficient and correct use of static variables 

4. Implementing pre-processing / initialisation in the Analysis window 

5. Accessing ---Equity symbol 

Generally speaking the AFL formula can run in full speed only if it does not access any shared resources. Any 
attempt to access shared resource may result in formula execution waiting for the semaphore/critical section 
that protects shared resource from simultaneous modification. 

1. Avoiding the use of OLE / CreateObject 

AmiBroker fully supports calling OLE objects from AFL formula level, and it is still safe to use, but there are 
technical reasons to advocate against using OLE. The foremost reason is that OLE is slow especially when 
called not from "owner" thread. 

OLE was developed by Microsoft back in 1990's in the 16-bit days it is old technology and it effectivelly 
prevents threads from running at full speed as all OLE calls must be served by one and only user-interface 
thread. For more details see this article: 

http://blogs.msdn.eom/b/oldnewthing/archive/2008/04/24/8420242.aspx 

For this reason, if only possible you should strictly avoid using OLE / CreateObject in your formulas. 

If you fail to do so, the performance will suffer. Any call to OLE from a worker thread causes posting a 
message to OLE hidden window and waiting for the main application Ul thread to handle the request. If 
multiple threads do the same, the performance would easily degrade to single-thread level, because all OLE 
calls are handled by main Ul thread anyway. 

Not only that. Threads waiting for OLE can easily deadlock when OLE server is busy with some other work. 
AmiBroker contains some hi-tech patented code that checks for such OLE deadlock condition and is able to 
unlock from it, but it may take even upto 10 seconds to unlock. Even worse. OLE calls made from non-UI 
thread suffer from overhead of messaging and marshaling and can be as much as 30 slower compared to 
when they are called from same process main Ul thread. To avoid all those troubles, avoid using OLE if only 
possible. 

For example instead of using OLE to do RefreshAII like this: 

AB = CreateObject("Broker.Application"); //AVOID THIS 
AB.RefreshAIIQ; // AVOID THIS 

Use AmiBroker native RequestTimedRefresh function which is orders of magnitude faster and does not cause 
any problems. If you want to refresh Ul after Scan/Analysis/Backtest use 
SetOption("RefreshWhenCompleted", True ) 

Keep in mind that in most cases the refresh is completely automatic (for example after AddtoComposite) and 
does not require any extra coding at all. 
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If you use OLE to read Analysis filter settings (such as watch list number), like this: 

AB = CreateObject("Broker.Application"); //AVOID THIS 

AA = AB.Analysis; // AVOID THIS 

winum = AA.Filter( 0, "watchlist"); // AVOID THIS 

you should replace OLE calls by simple, native call to GetOption that allows to read analysis formula filter 
settings in multithreading friendly manner. For example to read Filter Include watch list number use: 

winum = GetOption ( "FilterIncludeWatchlist ") ; // PROPER WAY 

For more information about supported filter settings fields see GetOption function reference page. 

Also note that AB.Analysis OLE object always refers to OLD automatic analysis window. This has side effect 
of launching/displaying old automatic analysis whenever you use AB.Analysis in your code. As explained 
above, all calls to OLE should be removed from your formulas if you want to run in New multithreaded 
Analysis window. It is only allowed to access new Analysis via OLE from external programs / scripts. To 
access new Analysis from external program you need to use AnalysisDocs/AnalysisDoc objects as described 
in OLE Automation interface document. 

2. Reducing use of AddToComposite / Foreign to minimum 

Any access to other than "current" symbol from the formula level involves global lock (critical section) and 
therefore may impact the performance. For this reason it is recommended to reduce use of 
AddToComposite/Foreign functions and use static variables wherever possible 

3. Efficient and correct use of static variables 

The access to static variables is fast, thread safe and atomic on single StaticVarSet/StaticVarGet call level. It 
means that it reads/writes entire array in atomic way, so no other thread will read/write that array in the middle 
of other thread updating it. 

However, care must be taken if you write multiple static variables at once. Generally speaking when you write 
static variables as a part of multi-symbol Analysis scan/exploration/backtest, optimization, you should do the 
writing (StaticVarSet) on very first step using Status("stocknum")==0 as described below. This is 
recommended way of doing things: 

if ( Status (" stocknum" ) == 0 ) 

{ 

// do all static variable writing/initialization here 

} 

Doing all initialization/writes to static variables that way provides best performance and subsequent reads 
(StaticVarGet) are perfectly safe and fast. You should avoid making things complex when it is possible to 
follow simple and effective rule of one writer - multiple readers. As long as only one thread writes and many 
threads just read static variables, you are safe and you don't need to worry about synchronization. 

For advanced formula writers only: 

If you, for some reason, need to write multiple static variables that are shared and accessed from multiple 
threads at the same time, and when you must ensure that all updates are atomic, then you need to protect 
regions of your formula that update multiple static variables with a semaphore or critical section. For best 
performance you should group all reads/writes in one section like this: 
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if ( _TryEnterCS( "mysemaphore" ) ) // see StaticVarCompareExchange function for 

implementation 
{ 

// you are inside critical section now 

// do all static var writing/reading here - no other thread will interfere here 
_LeaveCS(); 

} 

else 


_TRACE ("Unable to enter CS"); 

} 

The implementation of both semaphore and critical section in AFL is shown in the examples to 
StaticVarCompareExchange function. 

4. Implementing pre-processing / initialisation in the Analysis window 

Sometimes there is a need to do some initialization or some time consuming calculation before all the other 
work is done. To allow for that processing without other threads interferring with the outcome you can use the 
following if clause: 

if( Status("stocknum") == 0 ) 

{ 

/// initialization / pre processing code 

} 

AmiBroker detects such statement and runs very first symbol in one thread only, waits for completion and only 
after completion it launches all other threads. This allows things like setting up static variables for use in 
further processing, etc. 

5. Accessing ---Equity symbol 

Using Foreign("—Equity", "C") makes sense only to display chart of the equity of the backtest that has 
completed. It is important to understand that new Analysis window supports multiple instance, and therefore 
it can not use any shared equity symbol, because if it did, multiple running backtest would interfere with each 
other. So New Analysis has local, private instance of all equity data that is used during backtesting and only 
AFTER backtesting is complete, it copies ready-to-use equity data to —Equity symbol. This means that if 
you call Foreign("—Equity", "C") from within the formula that is currently being backtested, you will receive 
previous backtest equity, not current one. 

To access current equity, you need to use custom backtester interface. It has "Equity" property in the 
backtester object that holds current account equity. If you need equity as an array there are two choices, 
either collect values this way: 

SetOption ( "UseCustomBacktestProc" , True ); 

if ( Status ( "action" ) == actionPortfolio ) 

{ 

bo = GetBacktesterObjectO; 

bo.PreProcess(); // Initialize backtester 
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PortEquity = Null; // will keep portfolio equity values 

for(bar=0; bar < BarCount; bar++) 

{ 

bo.ProcessTradeSignals( bar ); 

// store current equity value into array element 
PortEquity[ i ] = bo.Equity; 

} 

bo.PostProcess(); // Finalize backtester 
// AT THIS POINT YOU PortEquity contains ARRAY of equity values 


} 

Or you can use EquityArray property added to Backtester object in v5.50.1 

if ( Status ( "action" ) == actionPortfolio ) 

{ 

bo = GetBacktesterObject (); 
bo.Backtest (); 

AddToComposite ( bo.EquityArray, // get portfolio Equity array in one call 
"-MY_EQUITY_COPY", "X", 

atcFlagDeleteValues | atcFlagEnableInPortfolio ); 

} 


Please note that values are filled during backtest and all values are valid only after backtest is complete (as in 
above example). If you call it in the middle of backtest, it will contain equity only upto given bar. Avoid abusing 
this function and it is costly in terms of RAM/CPU (however it is less costly than Foreign). 

Both ways presented will access local, current copy of equity in New Analysis (unlike Foreign that accesses 
global symbol values from previous backtest) 

Single-symbol operations run In one thread 

As explained at the beginning of the article, any operation such as scan, exploration, backtest, optimization or 
walk forward test that is done on single symbol can only use one thread. For that reason there is almost no 
speed advantage compared to running same code in the old versions of AmiBroker. 

Update as of 5.70: This version has a new "Individual Optimize" functionality that allows to run single-symbol 
optimization using multiple threads, albeit some limitations: only exhaustive optimization is supported and no 
custom backtester is supported. This is for two reasons: a) smart optimization engines need the result of 
previous step to decide what parameter combination choose for the next step; b) second phase of backtest 
talks to Ul and OLE (custom backtester) and as such can not be run from non-UI thread (see below for the 
details). 

Individual Backtest can only be run In one thread 

The most important thing to understand is that the Individual backtest is a portfolio-level backtest ran on just 
ONE symbol. Even if you run it on watch list, it still executes things sequentially, single backtest on single 
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symbol at once, then moving to next symbol in the watch list. Why this is so is described below. 

Both portfolio level and individual backtests consist of the very same two phases 

I. running your formula and collecting signals 

II. actual backtest that may involve second run of your formula (custom backtester) 

Phase I runs the formula on each symbol in the list and it can be multi-threaded (if there is more than one 
symbol in the list). 

Phase II that processes the signals collected in phase I, generates raport and displays results is done only 
once per backtest. 

It can not be multi-threaded because: 

a) it talks to User Interface (Ul) 

b) it uses OLE/COM to allow you to run custom backtester. 

Both OLE and Ul -i- access can not be done from worker (non user-interface) thread. Even worse OLE/UI -i- 
multithreading equals death, see: 

http://blogs.msdn.eom/b/oldnewthing/archive/2008/04/24/8420242.aspx 

Usually, in case of multi symbol portfolios. Phase I takes 95% of time needed to run portfolio backtest so once 
you run phase I in multiple threads, you get very good scalability as only 5% is not multi-threaded. 

Since individual backtest runs on ONE symbol then the only phase that can be run in multiple threads, i.e. 
phase 1 - consists of just one run, and as such is run in one thread. 

To be able to run Phase II from multiple threads you would NOT be able to talk to Ul and would NOT be able 
to use COM/OLE (no custom backtester). 

That causes that Individual Backtest can NOT be any faster than in old Automatic Analysis. 

Doing the math & resonable expectations 

Some users live in fantasy land and think that they can throw say 100GB data and the data will be processed 
fast because "they have latest hardware". This is dead wrong. What you will get is a crash. While 64-bit 
Windows removes 2GB per-application virtual address space barrier, it is not true that there are no limits 
anymore. 

Unfortunatelly even people with technical background forget to do the basic math and have some unresonable 
expectations. First and foremost thing that people are missing is the huge difference between access speeds 
made by data size. The term "Random Access Memory" in the past (like back in 1990) meant that accessing 
data takes the same amount of time, regardless of location. That is NO LONGER the case. There are huge 
differences in access speeds depending on where data is located. For example Intel i7 920, triple channel 
configuration accesses LI cached data with 52GB/second speed, L2 cached data 30GB/second (2x slower!), 
L3 cached data 24GB/second and regular RAM with 11 GB/second. It means that cached data access is 5 
times faster than RAM access. Things get even more dramatic if you run out of RAM and system has to go to 
the disk. With most modern BSD disks we speak about just 200MB/sec (0.2GB/sec). That is two orders (lOOx) 
of magnitude slower than RAM and three orders of magnitude slower than cache. That assumes zero latency 
(seek). In real world, disk access can be 10000 times slower than RAM. 

Now do yourself a favour and do the math. Divide 100GB by 0.2GB/second BSD disk speed. What you will 
get ? 500 seconds - almost ten minutes just to read the data. Now are you aware that if application does not 
process messages for just 1 second is considered as "not responding" by Windows? What does that mean? It 
means that even in 64-bit world, any Windows application will have trouble processing data sets that exceed 
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5GB just because of raw disk read speed that in best case does not exceed 200MB/sec (usuaiiy much worse). 
Attempting to backtest such absurd amounts of data on high-end PC wiii just iead to crash, because timeouts 
wiii be reached, the Windows wiii struggie processing messages and you wiii overrun system buffers. And it 
has nothing to do with software. It is just brutai math iesson that some forgot. First and most important ruie for 
getting more speed is iimit your data size, so it at ieast fits in RAM. 
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Ranking functionality 

A ranking is a reiationship between a set of items such that, for any two items, the first is either Yanked higher 
than', 'ranked iower than' or 'ranked equai to' the second. The simpiest way to obtain the rank is to sort items 
by 'vaiue' or 'score'. For exampie you can take 100-bar rate of change for symbois - it wiii be your item 'score' 
or 'vaiue. Then sort the results by it so you will get symbol list where first one is best performing (highest rate 
of change) and the last one is worst performing one. 

AmiBroker allows user to perform/use three different kind of rankings 

1. use ranking of trade entry signals (buy/short) to decide which entries are preferred over the others 
during portfolio backtesting/optimization 

2. display multiple rankings in tables created using Exploration 

3. generate numeric ranks for later use (general-purpose functionality) 

The first kind of ranking is performed automatically if your trading system formula defines PositionScore 
variable. You can use PositionScore variable to decide which trades should be entered if there are more 
entry signals on different securities than maximum allowable number of open positions or available funds. In 
such case AmiBroker will use the absolute value of PositionScore variable to decide which trades are 
preferred. For the details about ranking functionality during backtesting see Portfolio Backtester tutorial. 

Second kind of ranking is simply assigning a number (rank) to the line of exploration output. The rank column 
is added to the exploration output just by calling AddRankColumn function after performing a sort using 
SetSortColumns function. You can call SetSortColumns multiple times and you can call AddRankColumn 
multiple times to achieve many different ranks based on multiple-columns. See example below: 

Filter = 1; 

AddColumn ( Close, "Close" ) ; 

AddColumn ( Volume, "BI" ) ; 

AddSummaryRows ( 31 + 32, 1.5 ) ; 

AddRankColumn 0; // without prior sorting AddRankColumn just adds line number 

SetSortColumns ( -4 ); 

AddRankColumn 0; // rank according to 4th column (descending) 

SetSortColumns ( -3 ); 

AddRankColumn 0 ; // rank according to 3rd column (ascending) 


A third kind of ranking is general-purpose, bar-by-bar ranking that is performed using static variables. It is 
most resource hungry (computationally intensive) but also gives most possibilities. 

Generally the process involves creating static variables with values to be used for sorting/ranking, i.e. "scores" 
and then calling a special function (StaticVarGenerateRanks) that generates new set of static variables that 
hold calculated ranks. 

NOTE: This function is NOT intended to replace bakctester's built-in ranking via PositionScore. Just the 
opposite: whenever you can, you should use PositionScore as it is way way faster and less 
memory-consuming way to perform backtests with ranking. 
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StaticVarGenerateRanks is generally intended to be used for tasks OTHER than backtesting such as 
explorations or indicators that may require ranking functionality, but of course it can also be used for 
backtesting when/where PositionScore alone does not allow to implement what you need in your trading 
system. 

WARNING: this function is computationally and memory intensive. It takes about 20ms per 15K bars and 7 
symbols. Try to call it just once per scan/exploration/backtest using if( Status("stocknum")==0) or better yet, 
use separate scan just once to pre-calculate ranks and use it later (like composite creation scan). If you fail to 
do so and call StaticVarGenerateRanks for every symbol performance would drop significantly as this function 
not only needs lots of time to compute but it also has to lock the access to shared memory used by static 
variables so other threads trying to access static variables would wait until this function completes. 

StaticVarGenerateRanks function 

StaticVarGenarateRanks( "outputprefix", "inputprefix", topranks, tiemode ) is a core element of general 
purpose ranking system. It takes 4 parameters: "outputprefix" - the prefix appended to output static variables 
that hold the ranks, "inputprefix" the prefix of static variables holding scores (input), topranks - which defines 
how many top/bottom ranking symbols should be included in the generated rank set and tiemode that defines 
how ties (equal ranks) should be resolved. 

The "inputprefix" is a prefix that defines names of static variables that will be used as input for ranking. 
AmiBroker will search for all static variables that begin with that prefix and assume that remaining part of the 
variable name is a stock symbol. Say you want to rank stocks by ROC (rate of change). All you need to do is 
to store values into static variables. Let us say that we will use static variable names like "ItemScoreAPPL", 
"ItemScoreMSFT", and so on. 

To fill input static variables you can use this loop: 

for ( i = 0; ( sym = StrExtract ( symlist, i ) ) != "" ; i++ ) 

{ 

SetForeign ( sym ); 

Value = ROC( C, 10 ); 

RestorePriceArrays (); 

StaticVarSet ( "ItemScore" + sym. Value ); 

} 


Now you are ready to perform sorting/ranking. There are two modes, normal ranking mode and Top/Bottom 
Rank mode. Normal ranking mode is performed when toprank argument is set to zero. 

StaticVarGenerateRanks( "rank", "ItemScore", 0, 1224 ); 

In this case StaticVarGenerateRanks call would generate set of static variables starting with prefix defined by 
2nd argument each variable holding the rank of particular symbol, so in this case RankItemScoreMSFT will 
hold ranking of MSFT, RankItemScoreAAPL will hold ranking of AAPL. Note that in AmiBroker rank count start 
from ONE. 

Third argument (topranks) is zero in normal ranking mode. Fourth argument (tiemode) defines how ties are 
ranked. Supported modes are 1234 and 1224. In 1224 mode ties are numbered with equal rank. 

Example code for normal ranking mode (everything done is done in one pass, can be used in indicator): 
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symlist = "C,CAT,DD,GE,IBM,INTO,MSFT" ; 

// delete static variables 
StaticVarRemove ( "ItemScore*" ) ; 

// fill input static arrays 

for ( i = 0; ( sym = StrExtract ( symlist, i ) ) != "" ; i++ ) 

{ 

SetForeign ( sym ); 

Value = ROC( C, 10 ); 

RestorePriceArrays () ; 

StaticVarSet ( "ItemScore" + sym. Value ); 

} 

// perform ranking 

StaticVarGenerateRanks ( "rank", "ItemScore", 0, 1224 ); // normal rank mode 
// read ranking 

for ( i = 0; ( sym = StrExtract ( symlist, i ) ) != "" ; i++ ) 

{ 

Plot ( StaticVarGet ( "RankItemScore" + sym ), sym, colorCustomlO + i ); 

} 

Top/bottom ranking mode (that generates top/bottom ranking tabies that hoid indexes to top ranking vaiues. 
When topranks > 0 top ranked vaiues are used, when topranks < 0 then bottom ranked vaiues are used. The 
vaiues are stored in variabies that have format of: 

OutputprefixInputprefixN where N is a number 1,2, 3 representing top/bottom ranks. Let us assume that 
OutputPrefix parameter is "Top" and Inputprefix parameter is ROC. In such case variabie TopROCI would 
hold the index of top rated value. TopROC2 would hold second top rated value, and so on. 
StaticVarGenerateRanks function uses rank numbering that starts from ONE. In top ranking mode 
StaticVarGenerateRanks will also prepare static variable that contains comma separated list of variable 
names that can be used to find out which index refers to which symbol. So if TopROCI holds 1 you would 
lookup first substring in TopROCSymbols variable to find out what variable (symbol) ranked at the top. 
Additionally StaticVarGetRankedSymbols gives easy-to-use method to retrieve comma separated list of 
ranked symbols for particular datetime. 

Example code for top ranking mode: 

symlist = "C,CAT,DD,GE,IBM,INTO,MSFT" ; 

// delete static variables 
StaticVarRemove ( "ItemScore*" ) ; 

// fill input static arrays 

for ( i = 0; ( sym = StrExtract ( symlist, i ) ) != "" ; i++ ) 

{ 

SetForeign ( sym ); 

Value = ROC ( C, 10 ); 

RestorePriceArrays (); 

StaticVarSet ( "ItemScore" + sym. Value ); 
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} 

// perform ranking 

StaticVarGenerateRanks ( "rank", "ItemScore", 0, 1224 ); // normal rank mode 
StaticVarGenerateRanks ( "top", "ItemScore", 3, 1224 ); // top-N mode 
StaticVarGenerateRanks ( "bot", "ItemScore", -3, 1224 ); // bottom-N mode 
// read ranking 

for (1=0; ( sym = StrExtract ( symlist, 1 ) ) != "" ; i++ ) 

{ 

Plot ( StaticVarGet ( "RankItemScore" + sym ), sym, colorCustomlO + 1 ); 

} 

sdt = SelectedValue ( DateTimeO ) ; 

Title = "{{NAME}} -{{DATE}} - {{VALUES}} TOP: " + StaticVarGetRankedSymbols ( 
"top", "ItemScore", sdt ) + 

" BOT: " + StaticVarGetRankedSymbols ( "bot", "ItemScore", sdt ) ; 


How to use StaticVarGenerateRanks in Anaiysis window 

Since ranking is resource hungry process, it shouid be performed just once per Anaiysis run, not for every 
symboi. You can achieve it either by running separate ranking-generation formuia once by hand prior to 
running Anaiysis or using Status("stocknum") == 0 statement that wouid ensure that ranking process is done 
oniy for the very first symbol from the watch list under analysis. 

Here is an example code for exploration that takes currently active watch list or all symbol list and performs 
ranking 

if ( GetOptlon ( "ApplyTo" ) == 2 ) 

{ 

wlnum = GetOptlon ( "FllterIncludeWatchllst" ); 

List = CategoryGetSymbols ( categoryWatchlist, wlnum ) ; 

} 

else 

if ( GetOptlon ( "ApplyTo" ) == 0 ) 

{ 

List = CategoryGetSymbols ( categoryAll, 0 ); 


else 

{ 

Error ( "The formula works fine If your ApplyTo setting Is 'Filter' or 'All' 

" ) ; 

} 


if ( Status ("stocknum") == 0 ) // GENERATE RANKING WHEN WE ARE ON VERY FIRST 

SYMBOL 
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{ 

StaticVarRemove ( "values*" ); 
for ( n = 0; ( Symbol = StrExtract ( List, n ) ) != 

{ 

SetForeign ( symbol ); 
values = RSI (); 

RestorePriceArrays (); 

StaticVarSet ( "values" + symbol, values ); 
_TRACE ( symbol ); 

} 

StaticVarGenerateRanks ( "rank", "values", 0, 1224 ) ; 

} 

symbol = Name(); 

values = StaticVarGet ( "values" + symbol ); 
rank = StaticVarGet ( "rankvalues" + symbol ); 

AddColumn ( values, "values" ) ; 

AddColumn ( rank, "rank" ) ; 


Filter = 1; 

SetSortColumns ( 2, 4 ) ; 


n++ ) 
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Using AFL Code snippets 

Code snippet is a smaii piece of re-usabie AFL code. It can be inserted by 

• right-ciicking in the AFL editor window and choosing "Insert Snippet" menu, or 

• dragging a snippet from Code Snippet window, or 

• typing keyboard trigger (such as @for) in the editor 

0 AFL Formuia Editor - [Formula 46.afl] 


File Edit View Tools Window Help 
Dli^B Formula 46 


►HApply » ^ 


Formula 46.afl X 


Insert Snippet ► 

Charts ► 



Cut 

Composites ► 



Cop-. 

Conditional ^ 


m 

Paste 

Custom backtest ► 

CBT Hi-level 

X 

Delet: 

File *■ 

CBT Hi-level trade list 

tn 

Undo 

Loops y 

CBT Mid-level 


Redo 

Position sizing ► 

CBT Low-level 


Select Mil 

Static variables r 

Custom metric simple 

K 


Find 

Stops ► 

Per-trade custom rlr^ric 



Trading system ► 



Print 


User category ► 


Parameter jnfo 

Function reference 






In version 5.90 Code snippets are aiso avaiiabie in auto compiete iist in the AFL Editor. Just type @ pius first 
ietter of snippet key trigger and auto-compiete iist wouid show you the iist of avaiiabie snippets that have 
keyboard triggers defined starting with that ietter. 

Repiacement of keyboard triggers works even without auto complete activated, so just typing @keytrigger is 
replaced by snippet text. 


Using AFL Code snippets 


278 













AmiBroker 6.00 User's Guide 


Tutorial 


^ AFL Formula Editor - [ 



mo- Formula 22 

; File Edit View Tools Window Help 


"ty tHApply 



Formula 22^fl x 



■i @fileread 
■1 ©filewrite 
■i ©for 
^ ©forlist 
■i ©fun 
■i ©funlocal 
■E ©funmultiple 



Auto-complete list 
with code snippets 


DEFINING YOUR OWN SNIPPETS 

You can add your own snippets fairly easy using new Code Snippet window. Code Snippets window is 
available in new AFL editor. It can be shown/hidden using Window menu. 

To create your own snippet, do the following: 

1. type the code you want 

2. select (mark) the code you want to place in a snippet 

3. press Save selection as snippet button in the Code Snippets window 
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If you do the steps above the following dialog will appear: 



Now you need to enter the Name of the snippet, the Description and Category. Category can be selected 
from already existing items (using drop down box), or new category name can be typed in the category field. 
Key trigger field is optional and contains snippet auto-complete trigger (described above). The Formuia field 
is the snippet code itself. Once you enter all fields and press OK, your new snippet will appear in the list. 
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- X [S’ i. 


LJ Charts 
r~l Composites 
LJ Conditional 
LJ Custom backtest 
LJ File 
LJ Functions 
> LJ Loops 
LJ Position sizing 
>LJ Static variables 
LJ Stops 

LJ Trading system 
A LJ User category 
^ My Snippet Name 

My Snippet Name 

This snippet gets symbols from 
watch list that is currently selected 
in the Analysis window 


From then on you can use your own snippet the same way as existing snippets. Perhaps most convenient 
method is using drag-drop from the iist to AFL editor. 

As you may have noticed user-defined snippets are marked with red coior box in the Code Snippets list. Only 
user-defined snippets can be overwritten and/or deleted. 

To edit existing user-defined snippet, you can either follow the steps above and give existing name. 
AmiBroker will ask then if you want to overwrite existing snippet, or you can simply click on Properties button 
and edit the snippet directly, without re-inserting it. 



Delete Properties 


To delete a snippet, select the snippet you want to delete from the list and press Delete (X) button in the Code 
Snippet window. 


TECHNICAL INFO (advanced users only) 

There are two files located in AmiBroker directory that hold snippets: 

CodeSnippets.xml - these are snippets shipped with AmiBroker installation (and can be replaced in 
subsequent installations, so don't modify it!) 

UserSnippets.xml - these are user-definable snippets. This file is NOT present in the installation and user can 
create it by him/herself. 

The XML schema for snippets file is simple (as below). Key trigger functionality is NOT yet implemented. 
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however Keytrigger fields should be included in the definition for future use. It will be work like 'autocomplete' 
so that you type the shortcut it, it will unfold to the formula. 

<?xml version="l.0" encoding="ISO-8859-1"?> 

<AmiBroker-CocieSnippets CompactMocie= " 0 " > 

<Snippet> 

<Name>First Snippet</Naine> 

<Description>Description of the snippet</Description> 

<Category>U ser category </Category> 

<KeyTrigger> ?triggerl </KeyTrigger> 

<Formula> 

<![CDATA[ 

// the formula itself 

]]> 

</Fonnula> 

</Snippet> 

<Snippet> 

<Name>Second Snippet</Name> 

<Description>Description of the snippet</Description> 

<Category>U ser category </Category> 

<KeyTrigger>?trigger2</KeyTrigger> 

<Formula> 

<![CDATA[ 

// the formula itself 

]]> 

</Formula> 

</Snippet> 

</AmiBroker-CocieSnippets> 
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Video Tutorials (on-line) 

For your convenience we have prepared the following Video Tutorials (in Macromedia Flash format) on our 
web page: 

• How to install AmiBroker 

• How to use drag-and-drop charting interface 

• How to setup new database with eSignai RT feed (RT version) 

• How to setup new database with iQFeed RT feed (RT version) 

How to setup new database with Interactive Brokers (RT version) 

• How to use AmiQuote in 'manual' mode 

• How to use chart sheets and layouts 

• How to use layers 

• How to use AFL Code Wizard 

For more video tutorials please check: 
http://www.amibroker.com/support.html 
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• AmiBroker User Interface Reference 

• ASCII Importer reference 

• AmiBroker's OLE automation object modei 

• AmiQuote's OLE automation object model 
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Windows 

This part describes functionaiity of AmiBroker windows. 

Aii these windows are asynchronous i.e. you can open as many windows as you iike, and work with aii of 
them at the same time. 

Charting 

• Chart window pane 

• Data window 

• Parameters window 

• Study drawing toois 

• Line study properites window 

• Text box properties window 

• Formuia editor 

• Risk-yieid map window 

• Piace order window 


Settings 


• Database settings / intraday settings 

• Preferences 

• Customize toois window 

Symboi / Data 

• Symboi tree 

• information window 

• Notepad window 

• Quote Editor window 

• Symboi finder window 

• Finance window 

• Profiie view 

• Assignment organizer window 

• Composite caicuiator window 

• Categories window 

• import Wizard window 

• Metastock importer window 

• Reai-time Quote window 

• Easy Aierts window 

• Time/Saies window 

• Bar Repiay window 

Anaiysis/Toois 

• Formuia editor 

• Code Snippets window 

• Quick review window 

• Anaiysis window 

• Fiiter settings window 


Windows 
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• System test settings window 

• Commission scheduie window 

• System test report window 

• Commentary window 

• Plugins window 

• Indicator Maintenance wizard 

• Log window 

• Performance Monitor 


Windows 
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Chart window pane 

Chart title 


Pick color Thjck Dotted Snap to pric 



^ AmiBroker -VdjI - DOW JONES INDUSTR - Daily] 


File Edit \View Insert Format Symbol Analysis lools Window Help 

□ y S ® ^ Q X >0 O O 0 ; ^ ''DJKDOwjor 

J ''DJI (D^ X [ 


o 


< > 


'DJI - Daily 2010-03-17 Open 10686.4, Hi 10787.9, Lo 10658.1, Olose 10733.7 (0.4%) Vol 49 632 000 M,A(Close.15) = 10 ! Nq 775.9 


10 733.7 


10 27 ^ 2 ^ 


9 000 



y 

I 


9 600 


8 400 


7 800 


// 

# 
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O 

abc 


7 200 l+l 


'2009 'Feb 'Mar 'Apr 'May 'Jun / 'Jul '.Aug 'Ssp 'Oct 'Nov^ 'Dec '2010 'Feb 'Mar 

2 \ Shegt3 \ Gradient Chart/ Sheet 5 \ Sheet7 \ Sheet 7 ■‘.S < 

NYSE, Group 4, Serviyf, Advertising \ Data 



\i i > ►l.)^Shee 
Log window I I R 



Chart sheets Date/time axis Symbol lock Symbol link Interval link Scroll bar Y-axis area 

This window shows the chart of different technicai indicators. 


in the bottom of the chart you can see X axis, depending on Parameter window setting it may or may not 
dispiay dates, and beiow you can see scroii bar and chart sheets tab controi. Scroii bar can be used to dispiay 
past quotes, whiie sheet tab aiiows to view different chart pages/sheets (ciick here to iearn more about chart 
sheets). 

To the right you can see Y-axis area (marked with biue coior) that shows Y-scaie and vaiue iabeis. Vaiue 
iabeis are coior fieids that dispiay preciseiy the "iast vaiue" of piots. "Last vaiue" is the vaiue of the indicator 
(or price) for the iast currentiy dispiayed (rightmost) bar. Y-axis area is used aiso to move/size chart verticaiiy. 

Chart parameters and settings can be adjusted by ciicking with RiGHT MOUSE button over chart and 
choosing Parameters option from the chart context menu. 

Chart can aiso be scroiied, resized, moved, shrinked, resized - to iearn more about it piease read Tutoriai: 
Basic Charting Guide. 
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Parameters window 

This window aiiows the user to modify parameters specified in the AFL formuia via Param, ParamStr, 
ParamCoior, ParamStyie, ParamFieid, ParamToggie, ParamDate, ParamTime, ParamList functions and aiso 
to adjust axes and grid settings. 

it is accessibie via chart context menu (right ciick the mouse over the chart pane to see the context menu) : 
choose Parameters and a smaii window with parameter iist wiii appear. To edit parameter vaiue simpiy ciick 
on the item vaiue fieid as shown in the picture. Then depending on type of the parameter appropriate 
controi(s) wiii appear. 

For exampie, if given parameter is a string then text fieid wiii appear, and if given parameter is coior then 
coior-picker controi wiii aiiow you to change the coior. 

When editing numeric parameters you can adjust the vaiue by either entering the vaiue to the edit fieid or by 
moving a siider controi. To show the edit fieid - ciick on the number itseif (marked with biue coior in the picture 
beiow). To show a siider controi ciick next to the number (right-hand side). 

if given parameter is a number then siider or the edit fieid wiii be shown as in the picture beiow: 


Properties of: Price 


Ciick on parameter field to display 
a slider or other control that allov^s 


Parameters Axes & to adlust a value on-the-flv 

El Long MA 

Price field 

Qose 

Periods 

100 I " 

Color 

1 Bright green 

Style 

El B Bands 

B Volume 

□ Lavender 

Histogram Thick No Label... 

B Prica Interpretation 


yime MA 

MA(aose.26) 

mi^>4ma 

Mid MA(aose.45) 

Long \iti» MA 

Long MAtOose.lOO) 

BBTop\\ 

BBTop(aose.15.2) 


Section names 


Reset all 


OK 


You can move the slider using mouse, <- -> cursor keys and mouse wheel. As changes are made underlying 
chart is immediately refreshed giving great feedback for the user. 

Parameters are grouped into "sections". Sections represent part of the codes surrounded by 
_SECTION_BEGIN/_SECTION_END markers. To learn more about this check Tutorial: Using drag-and-drop 
interface. 

At any time you can press Reset all button that will reset all parameters to default values. 

For more information on using parameters please read Tutorial: Using colors, styles, titles and parameters in 
the indicators and Tutorial: Using drag-and-drop interface. 
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Parameter window allows also to control axes and grid appearance as well as some other per-chart settings. 
These controls are available in the second Axes & Grid tab as shown below: 


Parameters 


Axes & Grid 


El Axes 



> 

Scaling 

Automatic 



Minimum fi 

16.757219 



Maximum tt 

28.256546 



Type 

Linear 

* 


Show date axis^ 

Yes 


- 

a Gnd 




Show middle lines 

Yes 



Show upper/lower limits 

No 



Show '4 values 

No 



Levels 




Format 

0 - Decimal (auto) 



a Miscellaneous 




Show trading arrows 

No 


- 


The following options are available: 

• Axes 

♦ Scaling: 

0 Automatic - minimum and maximum value of Y axis is determined automatically by 
AmiBroker 

0 Custom - minimum and maximum value of Y axis are user-defined 

♦ Minimum - minimum Y axis value (this property is locked if automatic scaling is selected, to 
unlock choose Custom scaling) 

♦ Maximum - maximum Y axis value (this property is locked if automatic scaling is selected, to 
unlock choose Custom scaling) 

♦ Type 

0 Linear - use linear Y axis scale 
0 Logarithmic - use logarithmic Y axis scale 

♦ Show date axis - turn on/off date display on X axis 

• Grid 

♦ Show middle lines - display automatic Y axis grid lines spaced evenly between minimum 
and maximum 

♦ Show upper/lower limits - display minimum and maximum Y axis value labels 

♦ Show % values - display values as percents 

♦ Levels - allows to turn on grid lines at some fixed, popular levels such as 30/70, 20/80, 10/90, 

-100/-P100, 0 

• Miscellaneous 

♦ Show trading arrows - when turned ON this pane will show buy/sell/short/cover arrows 
generated by corresponding options available from Automatic Analysis menu. 

♦ File path (locked) - shows the path to the formula file that given chart uses 

♦ Chart ID (locked) - shows the numeric value of Chart ID given pane uses. Chart ID does not 
matter unless you use Study() function in your formula(s). 
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Data window 


Data window can be displayed using 

Window->Data Window menu 

The Data Window shows the date/time and values 
of open, high, low, close, volume, open interest, 
aux1 and aux2 of the bar under the mouse cursor. 
It also shows mouse cursor Y-coordinate ("Value") 
expressed in terms of price corresponding to 
current mouse cursor location. 

The Data Window also shows the values of all 
indicators defined in the formula. These values are 
automatically updated when cursor stops moving 
for a fraction of a second. 


Data Window 




Item 

Value 

Date 

2009-12-17 

Time 


Value 

38.123 

Open 

40.7479 

High 

40.8972 

Low 

40.0908 

Close 

40.27 

Volume 

81475 

Open Int. 

0 

Auxl 

0 

Aux2 

0 

Close 

40.27 

MA(Close,15) 

40.2587 

Mid MA(Clos... 

38.5776 

Long MA(Clo... 

35.265 

BBTop(Close,... 

42.0268 

BBBot(Close,... 

38.4905 

VolumeO 

81475 
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Study drawing tools 

AmiBroker's study drawing tools are accessible from Draw / Fibonacci & Gann toolbars: 


X 

Select 

/■ 

Trendline 

/ 

Ray 

/ 

Extended 

I 

Vertical 


Horizontal 

// 

# 

Parallel 

Regession 

Channel 

□ 

Rectangle 

o 

Ellipse 

abc 

Text 

A 

Triangle 


Pitchfork 

r\ 

Arc 

l-H 

Cycles 

— 

Fibcnacd 

Retracement 

Ill 

Time zones 


Fib.Fan 


Fib. arc 

ffl 

Gann square 


Gann fan 

= 

Fibcnacd 

extension 

Hi 

Time 

extension 


The following tools are available: 

• trend line 

• ray (new in 4.20) 

• extended line (new in 4.20) 

• vertical line 

• horizontal line 

• parallel lines (new in 4.20) 

• Regression channels: Raff, standard deviation, standard error (all new in 4.20) 

• Fibonacci Retracement study (enhanced in 4.20) 

• Fibonacci Time zones study 

• Fibonacci Extensions (new in 4.60) 

• Fibonacci Time Extensions (new in 4.60) 

• Fibonacci Fan 

• Fibonacci arc 

• Gann Square (new in 4.20) 

• Gann Fan (new in 4.20) 

• Ellipse tool 

• Triangle tool (new in 4.30) 

• Andrews' pitchfork (new in 4.30) 

• Cycles tool (new in 4.60) 

• Arrow tool (new in 4.70) 

• Zig-zag tool (new in 4.70) 

• Arc tool 

• Rectangle 

• text box tool 


The default Select iool (red arrow) is used to select drawing objects and quotations on the 
chart. If you want to draw given study just switch on appropriate button and start drawing on 
the chart by pointing the mouse where you want to start the drawing and click-and-hold left 
mouse button. Then move the mouse. Study tracking line will appear. Release left mouse 
button when you want to finish drawing. You can also cancel study drawing by pressing ESC 
(escape) key. For beginners' guide to charting check Tutorial: Charting guide 


Trend line, Ray, Extended, Vertical, Horizontal 

These tools give different flavours of basic trend line. Trend line gives a line segment, Ray gives 
right-extended trend line. Extended gives trend line that is extended automatically from both left- and right- 
sides. Vertical and Horizontal are self-explaining. 

Arrow 

Similar to Trend line but ends with an arrow 

Zig-zag 
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Draws a series of connected trend lines. To end drawing press ESC key. 

Parallel 

This tool allows to draw a series of parallel trend line segments. First you draw a trend line as usual, then a 
second line parallel to the first is automatically created and you can move them around with the mouse. Once 
you click on the chart it is placed in given position. Then another parallel line appears that can be placed 
somewhere else. And again, and again. To stop this please either press ESC key or choose "Select" tool. 

Regression channels 

AmiBroker allows to draw easily 3 kinds of regression channels: 

• Raff regression channel 

• Standard error channel 

• Standard deviation channel 

All these channels are based on linear regression trend line. 

The Regression Channel is constructed by plotting two parallel, equidistant lines above and below a Linear 
Regression trendline. The distance between the channel lines to the regression line is the greatest distance 
that any one high or low price is from the regression line. 

Standard Error Channels are constructed by plotting two parallel lines above and below a linear regression 
trendline. The lines are plotted a specified number of standard errors away from the linear regression 
trendline. 

Standard Deviation Channels are constructed by plotting two parallel lines above and below a linear 
regression trendline. The lines are plotted a specified number of standard errors away from the linear 
regression trendline. 

You can choose the type of channel by double clicking on the channel study (or choosing Properties from 
right mouse button menu) 


Study drawing toois 


292 



AmiBroker 6.00 User's Guide 


AmiBroker Reference Guide 



If Use common color and style box is marked channel lines use the same style and color as regression 
(middle) line. If it is not marked you can set separate colors and style for upper and lower channel line. You 
can also switch off completely upper and lower channel lines by unticking Show Upper line and Show Lower 
line boxes. 

"Study ID" column defines study identifier that can be used in your custom formulas to detect crossovers. You 
can change these IDs if required by simple editing these fields. For more information on Study IDs check 
Tutorial: Using studies in AFL formulas 

More information on regression channels is available from Technical analysis guide. 

Ellipse and Arc drawing tools 

These new drawing tools are connected to the date/price coordinates (as trend lines) rather than to the screen 
pixels so they can change the visual shape when displayed at various zoom factors or screen sizes. 

To see the properties of these elements you should double-click on the clock-like 3, 6, 9 or 12 hour positions. 

Fibonacci arc 

This new drawing tool generates standard Fibonacci-arcs that are controlled by the trend line drawn with a 
dotted style. To see the properites of the arcs click on the controlling trend line. 

Note that arc radius and central point are relative to the controlling trendline and because Fibonacci arcs must 
be circular regardless of screen size/resolution and zoom factor the position of the arcs may move in 
date/price domain. 

Fibonacci retracement 
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First please note that Fibonacci tool works differently depending on the direction of drawing and "show 
extensions" flag. See the pictures below. 


iei.8% 

OpwarcTdrawing direcxion 

A 

127.2% 

/ 

0.0% 


■^2% 

. 

' k / Tli. \ 

.SOife J 

ei8%^ 





100 . 0 ^ 



127 . 2 % 


161 ' 8 %. 

Upward drawing direction Upward drawing direction 

Show Extensions ON Show Extensions OFF 

as you can see it shows both retrace levels (38.2, 50, 61.8) and extension levels (127.2, 161.8). If "show 
extensions" box is OFF the tool shows ONLY retrace levels. It works in a similar way when controlling trend 
line is drawn downwards. 
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■8573 


127.2^ 75.71 



^ I 

' s' 

' s' 

's' 

Downward drawing direction 
Show Extensions ON 



.32.67 

' i' 

'i' 

i6i8‘^."23.45 

Downward drawing direction 
Show Extensions OFF 


Now more about Fibonacci settings window: 



First coiumn "Show" switches particuiar iine ON/OFF 

Second coiumn "Levei (%)" defines percentage ievei. 100 and 0 represent Y-coordinate 


Study drawing toois 


295 


































































































































































AmiBroker 6.00 User's Guide 


AmiBroker Reference Guide 


of begin and end points of controiiing trend iine. 

Third coiumn "Color" defines coior of the iine, Fourth coiumn "Style" aiiows 
to choose between reguiar, thick and dotted styies. 

Fifth and Sixth coiumns "Left side" and "Right side" controi dispiay of text 

that appear on the ieft and right side of the Fibonacci ievei iine. Empty - means no text, 

% - means percentage ievei, $ - means doiiar (point) ievei. 

Seventh coiumn "Study ID" defines study identifier that can be used in your custom formuias 
to detect crossovers. Each Fibonacci ievei has a separate ID be defauit FO... F9. 

You can change these IDs if required by simpie editing these fieids. 

As described in User's Guide: Tutoriai: Using studies In AFL formulas 

you can easity write the formuia that checks for penetration of particuiar Fibonacci ievei. 

In this exampie we wiii detect if the dosing price drops F2 (38.2% retracement) ievei iine. The formuia is very 
simpie: 


sell = cross ( study( "F2" ), close ); 

Note that study() function accepts two arguments: the first is StudylD two ietter code that corresponds to one 
given in properites diaiog; the second argument is chart ID - by default it is 1 (when it is not given at all) and 
then it references the studies drawn in the main price pane. For checking studies drawn in other panes you 
should use the codes given above (in the table describing study() function). 

Please note that this formula is universal - it will use appropriate level from any symbol that has Fibonacci 
lines drawn. 

This is so because AmiBroker keeps data of all studies drawn in its database. 

When you scan using above code - AmiBroker checks if Fibonacci levels are drawn for symbol being currently 
scanned, 

if it finds one - it looks what F2 study is - it finds that this is a fibonacci line 38.2% located (for example for 
particular symbol) at $29.06 

so AmiBroker internally substitutes study( "F2") by $29.06 (caveat: this is simplification - in fact it internally 
generates array that represents a trend line) and checks for cross. 

"Extension factor" decides how far lines are right-extended (in X-axis direction). If you enter 2 you will get 
lines extended twice as much as default'T. If you enter 0 Fibonacci level lines will end where controlling trend 
line ends. 

"Use as default" - if you check this box and accept the settings by clicking OK - all Fibonacci drawings that 
you will draw later will use these settings. 

When using text box tool just type the text in the box, when you want to finish click outside the text box. You 
can also cancel editing by pressing ESC key. 

Fibonacci Extensions 

The Fibonacci Extensions tool is similar to the Fibonacci Retracements tool. The Fibonacci Extensions tool 
requires a third point. The extensions and retracement levels are drawn from this third point, but based upon 
the distance between the first two points. A common use of this tool is to first connect two points that 
represent the endpoints of a major trend (or wave). Then choose the third point to be the endpoint of a 
retracement of that trend. Extensions are then drawn in the direction of the initial trend, from the third point, 
using the distance between points one and two as a basis for the extension levels. 
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The Fibonacci Extensions tooibar button and drawing tooi work much iike the Andrew's Pitchfork drawing tooi. 
First, ciick on the Fibonacci Extension button on the tooibar. Then, dick three times, once on each of the 
points that are invoived in the Fibonacci Extension. The first ciick shouid be on the starting point of the initiai 
trendiine. The second ciick shouid be on the ending point of the initiai trendiine. The third ciick shouid be on 
the ending bar of the retracement period. 

As with Fibonacci Retracements, there is a great deai of fiexibiiity via Fibonnacci settings tab avaiiabie after 
ciicking on the study with a right mouse and seiecting "Properties" from the context menu. 

Fibonacci Time Extensions 

Fibonacci Time Extensions tooi is used to specify verticai iines at date/time ieveis which are determined to be 
probabie vaiues of changes in trend based on the market’s previous date/time range and a third extension 
point. 

The time extension tooi shouid be used as foliows. First, ciick on the Fibonacci Time extension button on the 
tooibar. Then seiect the first range point (typicaiiy a major top or bottom of a market) by ciicking on the chart 
where you want the range to begin, then move the mouse pointer to seiect the second range point by again 
ciicking on the chart where you want the range to end. Extension iines now wiii be drawn onto the future bars. 

As in Fibonacci Price retracement and extensions toois you have compiete controi over which percentages 
are used in the Time Extensions tooi, and the coiours of each of the extension vaiues via Properites diaiog. 

Gann square and Gann Fan 

Gann Squares indicate possibie time and price movements from important highs and iows. To draw a Gann 
Square on a chart move the cursor on the chart to the starting point. The starting point is generaiiy an 
important Fligh or Low on the chart. Then drag the mouse to the right untii a desired ending point is reached. 
The start and end points wiii be the corners of the square. The ending point is often to the right of the chart 
bars. Watch for trends to change directions at the Gann Square ieveis. As the Gann Square is drawn to the 
screen the angie of the controiiing trend iine is shown in the status bar. 

Properties Window 
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The properties window is used to change the square levels, color, style, thickness, and defaults. Click on any 
of the Gann Square Show entries to add or remove lines. Click in the square color box to change the line 
color. Click on style combo boxes to change the line style. Check the Use as Default box to save the settings 
as the default for all subsequent Gann Squares that are drawn. "Left side" and "Right side" columns 
control display of text that appear on the left and right side of the Gann lines. Empty - means no text, % - 
means percentage level, $ - means dollar (point) level. "Study ID" column defines study identifier that can be 
used in your custom formulas to detect crossovers. You can change these IDs if required by simple editing 
these fields. For more information on Study IDs check Tutorial: Using studies in AFL formulas 

Triangle tool 

Triangle tool is self-explaining. Drawing a triangle is easy: left-click at the first point, hold down and drag to the 
second point, then release mouse button and drag to the third point and click once. The controlling triangle will 
become the pitchfork. 

Andrews' Pitchfork 

Andrews pitchfork is a study using parallel trendlines. In constructing the study, starting points are chosen. 

The first is a major peak or trough on the left side of the chart display. The second and third starting points are 
chosen to be a major peak and a major trough to the right of the first point. After all starting points have been 
decided, AmiBroker draws a trendline from the first point (the most left) so that it passes directly between the 
right most points. This line is called the handle of the pitchfork. The second and third trend lines are drawn by 
AmiBroker beginning at the starting points and parallel to the handle. Dr. Andrews suggested that prices make 
it to the median line (or handle) about 80% of the time while the price trend is in place. This means that while 
the basic long term price trend remains intact. Dr. Andrews believed that the smaller trends in price would 
gravitate toward the median line while the larger price trend remained in tact. When that does not occur, it 
may be evidence that a reversal in the larger price trend may be in progress or provides evidence of a 
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stronger bias at work in market. When price faiis to make it to the mediai iine from either side, it is often an 
expression of the reiative enthusiasm of buyers and seiiers and may predict the next major direction of prices. 
If prices faii to reach the median iine whiie above the median iine, it is a buiiish and faiiing to reach the median 
iine from beiow is bearish. 

Operating Andrews' Pitchfork tooi is simiiar to drawing triangie. Left-ciick at the first point, hoid down and drag 
to the second point, then reiease mouse button and drag to the third point and ciick once. The controiiing 
triangie wiii become the pitchfork. 

Cycles tool 

To use time cycies tooi, ciick on the cycies drawing tooi button in the tooibar then ciick at the starting point of 
the cycie and drag to the end of the cycie. These two controi points controi the intervai between the cycie 
iines. When you reiease the mouse button you wiii get a series of 
paraiiei iines with equai intervai in between them. 
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Line study properties window 



In the study properites window you can select start and end coordinates as well as line colours and styles. 
You can also enable automatic left- or right- line extension so that line will be extended when new quotes will 
be available. 

There are following fields available: 

• Start X, Start Y, End X, End Y - study start and end coordinates 

• Third X, Third Y - visible only for TRI-POINT studies like triangle, pitchfork - the coordinates of 3rd 
control point of the study 

• Lock position - if this field is marked it's impossible to chenge the position of the study with use of 
mouse 

• Coior - allows you to change the study color 

• StudyiD - defines Study ID which allows you to refer to the study from AFL formula. 

The detailed information is available in Using studies in your AFL formulas chapter. 

• Layer - indicates the layer that the study is placed on. 

To learn more about layers read Working with layers. 

• Z-order - defines the Z-order of the line. Lines, plots and graphics can be ordered in "Z" direction 
using Z-order. Learn more about this in Using Z-order tutorial. 

• Line width - (new in 5.90) specifies line width in pixels. Default line width is 1 pixel. 

• Thick - doubles the width of the line. The width is defined by Line width parameter. Turning this on 
makes the line twice as wide, so actual pixel width would be 2 * lineWidth. 

• Left / Right Extend - you can choose whether line is extended 

• Extension factor - (new in 5.90) - decides how far line is extended to left/right. Lines are extended in 
the direction of "X-axis" (i.e. date/time axis). 0 (zero) means infinite extension, one unit represents 
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X-axis distance between study end and start points. Fractionai vaiues are aiiowed. Aiiowabie range 

0 ... 25 . 5 . 

Line study properites window is accessibie from chart window's right mouse button menu. When you ciick on 
a study line with a right mouse button the following menu appears: 



Parameters... 


a 

Edit formula... 



Intraday 

► 

d 

Daily view 


w 

Weekly view 


m 

Monthly view 



Pane 

► 


Template 

► 


Symbol Link 

► 


Interval Link 

► 


Delete indicator 

► 


Lock symbol 


X 

Close 



Simply choose Properties to show the line study window. 
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Text box properties window 



Position: 

Start X: 

2009-08-25 

Text color; 


00:00:00 

Background; 

start Y: 

24.04184 


Layer; 

Defeult layer ▼ 

Transparent 



m 


In the text box properites window you can change the text displayed in the box, select start co-ordinates as 
well as text and background colours and transparent style. 


There are following fields available: 

• Start X, Start Y - text coordinates 

• Color - allows you to change the color of the text 

• Background Color - allows you to change the color of the background 

• Layer - indicates the layer that the text is placed on. To learn more about layers read Working with 
layers. 

Text box properites window is accessible from right mouse button menu. When you click on a text box with a 
right mouse button the following menu appears: 



Parameters... 

Edit formula... 



Intraday 

► 

d 

Daily view 


w 

Weekly view 


m 

Monthly view 



Pane 

► 


Template 

► 


Symbol Link 

► 


Interval Link 

► 


Delete indicator 

► 


D ■ • 



C 



Lock symbol 


X 

Close 






Simply choose Properties to show the text box properties window. 


Text box properties window 


302 



























AmiBroker 6.00 User's Guide 


AmiBroker Reference Guide 


In the text box properites window you can change the text displayed in the box, select start co-ordinates as 
well as text and background colours and transparent style. 


Text box properties window 
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Formula Editor 

A new AFL Formula Editor features: 

• Syntax highlighting (improved in 5.80) 

• Automatic brace matching/highlighting (NEW in 5.80) 

• Auto indentation (NEW in 5.80) 

• Indentation markers (NEW in 5.80) 

• Enhanced auto-complete in two modes (immediate (NEW in 5.80) and on-demand) 

• Parameter information tooltips 

• Line numbering margin and selection margin (NEW in 5.80) 

• Code folding (NEW in 5.80) 

• In-line Error Reporting (NEW in 5.80) 

• New tabbed user interface with ability to work in both MDI and separate floating frame mode, can be 
moved behind main AmiBroker screen and brought back (Window->Toggle Frame) (NEW in 5.80) or 
kept on top (Window->Keep on top) 

• Rectangular block copy/paste/delete (Use mouse and hold down left Alt key to mark rectangular 
block) (new in 5.80) 

• Auto capitalisation (change case) 

• Virtual space (new in 5.80) 

• Enhanced printing (with syntax highlighting and header/footer) 

• Code snippets (new in 5.80) 

These features greatly simplifies writing formula and provides instant help so time needed to write formula decreases significantly. 



Menu 
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Formula Editor menu options are described in detail in Menus: Formula Editor chapter of the guide. 

Toolbar 



The Formula Editor toolbar provides the following buttons: 

• New - clears the formula editor window 

• Open - opens the formula file 

• Save - saves the formula under current name 

• Print - prints the formula 

• Cut - cuts the selection and copies to the clipboard 

• Copy - copies the selection to the clipboard 

• Paste - pastes current clipboard content in the current cursor position 

• Undo - un-does recent action (multiple-level) 

• Redo - re-does recent action (multiple-level) 

• Formula Name - an EDIT field that allows to modify the formula file name, once you change the 
name here and press Save button the formula will be saved under new name and the change will be 
refleced in editor CAPTION BAR and in the STATUS BAR (Status bar shows full path). 

• Check syntax - checks current formula for errors 

• Apply indicator - saves the formula and applies current formula as a chart/indicator ONCE 

• Analysis - saves the formula and selects it as current formula in Automatic Analysis window and 
repeat most recently used Analysis operation (i.e. Scan or Exploration or Backtest or Optimization) 

Usage 

Typical use of Formula Editor is as follows: 

• open Formula Editor 

• type the formula 

• type meaningful name that describes the purpose of you code into Formula Name field 

• click Apply indicator button (if you have written indicator code) 

.. or.. 

click Analysis button to display Automatic Analysis window (when you have written exploration/scan 
or trading system) 

Syntax highlighting 

AmiBroker's AFL editor features user-definable syntax highlighting that automatically applies user-defined colors and styles to 
different language elements like functions and reserved variable names, strings, numbers, comments, etc. This feature greatly 
simplifies code writing. You can modify coloring scheme in Preferences window. 
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Enhanced error reporting 

When you make an error in your formula, AmiBroker's enhanced error reporting will help you to locate and fix 
an error by highlighting the place where error occured and displaying extended error description with the 
examples of common mistakes and advice how to fix them. In version 5.80 description of errors are displayed 
in-line with the code. 

A message bar displays total number of errors and/or warnings. If you press "Go to error" button the editor 
will move the caret to the relevant line with the error, if you press it again, it will move to the next error and so 
on. If you close the message bar with the "X" button all error messages will be cleared (hidden) from the view. 
You can use Edit->Clear Error Message menu (Ctrl+E) to clear individual error message (in the current line). 



Context help 

You can quickly display relevant AFL function reference page if you press F1 key or choose "Function 
reference" from the context menu while the caret is inside or right after function name as shown in the picture 
below: 
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Automatic statement completion 


The automatic completion feature (available when you press CTRL+SPACE key combination) finishes typing 
your functions and reserved variables for you, or displays a list of candidates if what you've typed has more 
than one possible match. You can select the item from the list using up/down arrow keys or your mouse. To 
accept selection press RETURN (ENTER). You can also type immediately space (for variables) or opening 
brace (for function) and AmiBroker will auto-complete currently selected word and close the list. To dismiss 
the list press ESC key. 
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tr = Trough( Close, Change )j 




pkbars = PeakBars( Close, Change 
trbars = Tro( Close, Change )j 


f TimeNum 
id Title 
id ToolTip 
f Trin 
f Trix 

> 

f 1 


f TroughBars 


id True 


f TSF 


typeof 

- 


)i 


Auto-complete box 

It works in two different modes: 

a) on-demand - it is displayed when you press CTRL+SPACE 

b) immediate - it is displayed automatically after you type 
first character 

In both modes the auto-complete box displays a list of 
matching keywords/functions and you can accept the entry 
by pressing ENTER or TAB keys. 


Parameter Information 

When you are typing a function, you can display a Tool Tip containing the complete function prototype, 
including parameters. The Parameter Info Tool Tip is also displayed for nested functions. 

With your insertion point next to a function, type an open parenthesis as you normally would to enclose the 
parameter list. 

AmiBroker displays the complete declaration for the function in a pop-up window just under the insertion point. 
Typing the closing parenthesis dismisses the parameter list. 

You can also dismiss the list if you press arrow up/down key, click with the mouse or press RETURN. 
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0 AFL Formula Editor - [Formula 49.afl] 


: File Edit View Tools Window Help 
l%ie|> 00 .| Formula49 


Formula 48.afl 


►^Apply " ^ ^ _ 



Formula 49^fl x 


tr = Tr-ough( Close, Change ); 


pkbars = PeakBa''5( Close, Change ); 
trbars = T'-cughBa''s( J 

TroughBars(^RRAX%changej^^Nth^=^^2J 



Parameter information tip 

Type opening brace ( after function name and 
parameter information tip will appear 


Editor configuration 

The settings of the AFL editor can be changed using Toois->Preferences, Editor page: 



Data 

Intraday Miscellaneous Alerc 

AFL 

Currenaes 

Charting 

Axes / Grids | Colors 

Bars & Candles 

Editor 


General 

[V] Auto change case [V] Copy as HTML 
M Parameter Info 

13 Virtual space [v] Use separate frame 

13 Move edited files from Drag-drop to Custom folder 
Font settings 
|Consolas, 10 pt 

Colors & styles 
I Background ^ 



Auto-complete: 
© Disabled 
© On-Demand 
@ Immediate 


Choose... 


OBold 

□ Bold 

□ Bold 

□ Bold 

□ Bold 
[3 Bold 

□ Bold 


OK 


Cancel 


Apply 


Help 


• Auto change case - controis whenever editor automaticaiiy changes case of reserved keywords (for 
example if user typed valuewhen it would change it to ValueWhen) 

• Parameter info - controls whenever parameter info tips are displayed 
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• Virtual space - controls whenever it is possible to place the caret freely in any place after the end of a 
line 

• Move edited files from drag-drop to custom folder - normally formulas created by drag-drop 
mechanism are located in hidden drag-drop folder, if you then want to edit them, you can do so in 
place so they remain in drag drop (hidden) folder, or you may choose to move them automatically to 
'custom' folder. This switch enables automatic move to custom folder 

• Copy as HTML - enables copies in HTML format so AFL code is copied with colors, without it it will be 
copied as plain text without formatting 

• Use separate frame - if turned on it displays AFL Editor in completely separate frame that behaves 
like separate application, if it is turned off, then AFL editor is displayed as a MDI tab within main 
AmiBroker frame (along with charts, analysis windows, web, account windows and so on). By default 
it is turned on 

• Auto-complete: in "On-demand" mode auto-complete list shows up only when you press 
Ctrl+SPACE, in "Immediate" mode auto-complete list pops up automatically as soon as you type first 
character (letter) of the identifier. 


Window control 


(Tl AFL Formula Editor - [Formula 49.afi]: 


L : File Edit View Tools 

Window Help 

M □ y ^ ^ 

Toggle Frame | 

I Formula 48.afl 

Keep on Top | 

tr = Trough( C' 

^ Cascade 


H Tile Horizontally 

pkbars = PeakB; 


trbars = Trougl] 

^ Tile Vertically 


1 Formula 48.afl 


v" 2 Formula 49.afl 


I ►SApply 


AFL Editor Window as a separate frame can be brought on top or to the back as any other application window 
using Windows Task Bar. In addition to that there is a Window->Toggle Frame menu (and Ctrl+' shortcut,' 
is the tilde key just above TAB key on most keyboards) that allows to quickly toggle between AmiBroker main 
frame and AFL editor frame. 

The user may also turn on Window->Keep On Top feature that keeps editor window on top of AmiBroker 
main frame. 

Margins 
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0 AFL Formula Editor - [Formula 49.afl] 


\ File Edit 

Vie 

Tools Window 

Formula 48.a 


Fold All 

Unfold All 

tr 


Line Numbers 

pk 

tr 

✓ 

Selection Margin 

V* 

Fold Margin 


Help 

la 49 ►aApply " ^ _ 



2 ); 

Change )j 




Toolbars ► 


Line numbers margin, Seiection margin and Foid margin can be switched on/off using View menu. In this 
menu there are also options to fold/unfold all code. 

Code snippets 

Code snippet is a small piece of AFL code. It can be inserted by: 

• right-clicking in the AFL editor window and choosing "Insert Snippet" menu, or 

• dragging a snippet from Code Snippet window, or 

• typing keyboard trigger (such as @for) in the editor 


0 AFL Formula Editor - [Formula 46.afl] 




File Edit View Tools Window Help 
DQ^B! ioo< Formula 46 


►gApply » ^ 


Formula 46.afl X 


Insert Snippet t 

Charts r 



Cut 

Composites ► 



Ccc;. 

Conditional ► 



Paste 

Custom backtest r 

CBT Hi-level 

X 

Delete 

File r 

CBT Hi-level + trade list 

m 

Unde 

Loops r 

CBT Mid-level 

ra 

Redo 

Position sizing ^ 

CBT Low-level 


jtlect «ll 

Static variables ► 

Custom metric simple 

K 


Find 

Stops ► 

Per-trade custom rlr^ric 


Print 

Parameter info 

Function reference 

Trading system ► 

User category ► 






For more information about Code snippets see Tutorial: Using Code-snippets 
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Code Snippets window 

Code snippets are small re-usable pieces of AFL code, detailed information on usage of Code Snippets can 
be found in this tutorial. 

Code Snippets window is available in new AFL editor. It can be shown/hidden using Window menu. 

INSERTING SNIPPET 

To insert an existing snippet, drag-drop the snippet from the Code Snippet list into AFL Editor, or double click 
on the snippet. 

CREATING YOUR OWN SNIPPET 

To create your own snippet, do the following: 

1. type the code you want 

2. select (mark) the code you want to place in a snippet 

3. press Save selection as snippet button in the Code Snippets window 



If you do the steps above the following dialog will appear: 


Code Snippets window 
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Now you need to enter the Name of the snippet, the Description and Category. Category can be selected 
from already existing items (using drop down box), or new category name can be typed in the category field. 
Key trigger field is optional and contains snippet auto-complete trigger (described above). The Formuia field 
is the snippet code itself. Once you enter all fields and press OK, your new snippet will appear in the list. 



- X li* i 


t> LJ Charts 
L_] Composites 
u Conditional 
LJ Custom backtest 
LJ File 

t> LJ Functions 
LJ Loops 

> LJ Position sizing 
LJ Static variables 
LJ Stops 

Trading system 
d LJ User category 

# My Snippet Name 

My Snippet Name 

This snippet gets symbols from 
watch list that is currently selected 
in the Analysis window 


From then on you can use your own snippet the same way as existing snippets. Perhaps most convenient 
method is using drag-drop from the list to AFL editor. 

As you may have noticed user-defined snippets are marked with red color box in the Code Snippets list. Only 
user-defined snippets can be overwritten and/or deleted. 
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EDITING SNIPPET 

To edit existing user-defined snippet, you can either foiiow the steps above and give existing name. 
AmiBroker wiii ask then if you want to overwrite existing snippet, or you can simpiy ciick on Properties button 
and edit the snippet directly, without re-inserting it. 



Delete Properties 


DELETING SNIPPET 

To delete a snippet, select the snippet you want to delete from the list and press Delete (X) button in the Code 
Snippet window. 
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Risk-Yield Map window 


^ Risk/Yield map 


HPQ 


;mcd 


UTX 


XOM ; 
3M ; 


CAT 


KO 


DIS 


JNl 


T MSFT 


INTCi, 


n/T WMl ' 

' MMM _hMRK 


AXP 


MO 


GE 




JPM 


IP 


AA 


EK 


fW 


TTO- 


This map provides fast information about risk and possibie yields. Yield is a the average weekly percentage 
return while Risk is a standard deviation of percentage weekly returns. On the X axis risk is presented and on 
Y axis - yield. Thus in the upper part of the map we have got symbols with giving best yield, with risk 
increasing from left to right side of the map. 

Selected symbol is marked with a different color, and you can zoom the part of the map by pressing left 
mouse button and marking rectangle to zoom in. 
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Place Order dialog 

NOTE; This functionality requires automated trading interface add-on that can be downloaded separately 

To place order from the chart please first choose lnsert->Buy Order or lnsert->Sell Order menu or 
appropriate buttons from Order toolbar, then AmiBroker will allow you to draw a horizontal line with mouse 
cursor over the chart. Simply click with LEFT mouse button over chart and hold it down - you a horizontal line 
will show marking the price level, once you move the line to correct level, release left mouse button to place 
the order (the following dialog will show up), or press ESC key to cancel entire operation. 



In the "Brokerage" currently selected trading interface is displaed. After installing Interactive Brokers 
automated trading interface (from http://www.amibroker.com/at/) the text "Interactive Brokers" should appear. 

If there is no trading interface installed the combo box will be empty. If you installed other trading interfaces 
they should appear in the list. 

In the "Action" field you can choose either Buy or Sell - note that preselected is the option choosen earlier 
from the menu or the toolbar. 

In the "Type" field you can choose order type (Market, Limit, Stop, StopLimit, etc), by default "Limit" order is 
selected. 

In the "Expiry" field you can choose how long given order will be valid. Currently available are Day and 
GoodTilCanceled. 

In the "Quantity" field you can enter the number of shares / contracts to buy/sell 

In the "Limit Price" field you can enter the limit price for the order - AmiBroker will fill the value selected on 
chart by default. 

In the "Stop Price" field you can enter stop price for Stop and Stop Limit orders. 

In the "Bracket" group you can choose additional automatic bracket orders. Bracket orders are "child" stop 
loss and/or take profit orders that are connected to main "Parent" order and work as OCA (one cancel 
another) group (so when for example take profit is triggered, the corresponding stop loss is canceled). Bracket 
prices are calculated automatically from Limit price. The distance between limit price and stop loss / take profit 
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levels Is defined by appropriate "offset" fields. The distance can be expressed In amount (dollars) or percent 
of limit price. 

All prices are subject to rounding depending on current symbol TIckSIze setting (see Information window). If 
TIckSIze Is not defined (I.e. Is equal to zero), then AmiBroker assumes 0.01 (one cent). 

Status field (highlighted In yellow) - shows the connection status between AmiBroker and trading Interface. 

Any connection error will be displayed here and In case of an error AmiBroker will disable "Accept" button will 
attempt to reconnect every 5 seconds. You can also manually trigger reconnection attempt by pressing button 
with two green arrows. 

When status field shows "Connected" then Accept button Is enabled and you can press It to place order. Note 
that currently the Interface places orders with Transmit flag set to FALSE. This means that orders are NOT 
actually transmitted to exchange but await manual transmit In the TWS. This Is safety measure. 

Once dialog Is closed by pressing Accept, the horizontal line showing the limit price entered will stay on chart. 
You can not move It by default, but you can delete It by selecting It and pressing "DEL" (Delete) key. 
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Database Settings 

This window aiiows you to define per-database settings, it is accessibie via Fiie->Database Settings menu. 



IMPORTANT: These per-database settings in this window take precedence over defauit vaiues definabie in 
Preferences window. See expianation in Tutoriai: Understanding database concepts. 

The database settings window is divided into two parts: General an6 Data source 

General settings part are enabied only at the database creation time (Flle->New database), once database 
is created these controis become disabied. 

• Browse... - aiiows to browse for foider where new database shouid be created. 

• Create - ciicking on this button creates the database inside the foider specified in Database folder 
edit fieid. 

For more detaiis about creating new database working with particuiar data source piease check Tutoriai 
section. 

Data source part becomes enabied once database is created and it can be used to modify settings for aiready 
existing databases (via Flle->Database Settings menu). The foiiowing controis are avaiiabie: 

• Data source: defines data souce, this can be either 

♦ (iocai) - it means that no externai source is used and data are maintained by AmiBroker itseif. 
Such database can be updated either using AmiQuote (Toois->Auto-update quotes) or using 
ASCii import - import Wizard, Metastock importer, or script. 

♦ externai data source (one of: eSignai, myTrack, QuoteTracker, Quotes Pius, TC2000/TCNet, 
FastTrack, Metastock) - it means that data are retrieved directiy from externai database / data 
source. Such database is updated automaticaiiy via piugin and does not require any user 
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action in AmiBroker. For exampie if you use TC2000 as a data source aii data that are 
present in TC2000 system become automaticaiiy avaiiabie in AmiBroker. For more detaiis 
piease read Tutoriai: Understanding database concepts. 

• Local data storage: decides if data from external data source shouid be stored/cached aiso in 
AmiBroker's own files. If "Enabled" then external data are cached in local files. If "Disabled" then local 
files do not store external data. Switching this to "Enabled" is required for most real-time data 
sources as eSignal, myTrack, QuoteTracker. This setting has no effect if data source is set to (local). 

• Number of bars to load - defines how many bars should be loaded from external data source and 
kept in AmiBroker. Examples: 10-years EOD: 2600, 60-days intraday 1-minute: 30000 (approx). This 
setting has no effect if data source is set to (local). 

• Base time Interval - defines what 'base' bar interval is used in this database. For real-time data 
sources this should be set once at the database creation time. This is so because real-time sources 
need to collect RT ticks and pack them (time-compress) into interval bars. This setting defines the 
minimum 'grain'. For EOD sources it is (End-of-day (daily). For real-time sources this should be 

1-minute or higher. For some real-time sources (like eSignal) this can be also set to tick, 5-sec or 
15-sec. 

Please note also that you won't be able to use Intraday charting and/or analysis until base time 
interval is set to something below end-of-day interval (it can be 1-minute for example). For more 
details please read Tutorial: Basic charting guide. 

• Flush cache - allows to force cache flushing and force retrieving fresh data from the plugin 

• Configure - allows to display data source specific configuration dialog see Tutorial section for details 
on configuring various data sources. 

• Intraday settings - allows to define per-database settings for intraday databases (see below) 

Intraday Settings window 
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• Filtering - this provides controi over the dispiay of intraday data. AmiBroker coiiects aii the data but 
dispiays oniy those data which are inside seiected trading hours start-end time. Piease note that this 
affects aii charts and windows except Quote Editor that aiways dispiays aii avaiiabie data. 

Show 24 hours trading (no filtering) - aii data are dispiayed (no fiitering at aii) 

Show day session only - oniy the data between day session (RTH) start and end times are 
dispiayed 

Show night session only - oniy the data between night sesison (ETH) start and times are dispiayed 
Show day and night session only - oniy the data between either day session start/end time or night 
session start/end time are dispiayed 

Filter weekends - when checked AmiBroker coiiects but does not dispiay data from weekends. When 
unchecked those data are coiiected and dispiayed. 

• Trading hours Start / End - defines trading hours start and end times for day (RTH) and night (ETH) 
sessions separateiy (see above). Piease note that the times shouid be specified in your iocai time 
zone. 

• Daily time-compression uses - this decides how AmiBroker performs intraday to daiiy time 
compression 

Exchange time - daiiy data are constructed from intraday bars starting from 00:00 and ending at 
23:59 in the EXCHANGE (or data source) TiME ZONE 

Local time - daiiy data are constructed from intraday bars starting from 00:00 and ending at 23:59 in 
the LOCAL (computer) TiME ZONE 

Day/Night session times as defined above - daiiy data are constructed from the intraday bars that 
start at the start time of night session (previous day) and end at the end time of day session) 

• Time shift - is the time difference (in hours) between your iocai time zone and the exchange time 
zone 

• Allow mixed EOD/Intraday data - it aiiows to work with database that has a mixture of intraday and 
EOD data in one data fiie. if this is turned on then in intraday modes EOD bars are removed on-the-fiy 
and in daiiy mode EOD bars are dispiayed instead of time compressed intraday or if there is no EOD 
bar for corresponding day then intraday bars are compressed as usuai. 

This mode works in conjunction with new versions of piugins that aiiow mixed data. As of June 2008 
Mixed mode is now supported by iOFeed piugin, eSignai piugin (1.7.0 or higher) piugins oniy. Mixed 
mode aiiows intraday pius very iong daiiy histories in one database. 


Note that Intraday Settings avaiiabie from Database Settings diaiog are PER-DATABASE. There is 
however aiso an option to define PER-GROUP intraday settings. To use PER-GROUP intraday settings you 
have to open Symboi->Categories window, switch to Groups tab and 
check "Group uses own intraday settings" box as shown in the picture beiow 
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Then you can click on Intraday Settings button to display per-group settings. Please note that each group in 
the category list can have its own individual settings so you can easily setup groups so they contain 
instruments traded in different hours. You can move symbols between groups using Symbol->Organize 
assignments dialog. 
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Preferences window 



Charting tab - allows you to modify charting options 

• Default number of quotations in a chart - this sets the amount of bars Initially displayed In the 
chart. (In other words It defines "normal" zoom range) 

• Blank bars in right margin - defines how many blank bars are added In the right margin (past the 
last available quote). This blank margin allows you to project studies (trend lines for example) Into the 
future 

• Quote selection only by CTRL+LMB - this decides how vertical selection line Is Invoked. When this 
box Is unchecked - single click on the chart causes display of the selection line, when this box Is 
checked you have to hold down CTRL key while clicking to get the selection line 

• Show verticai iine between days (intraday)/years(EOD) - this decides If dotted vertical line Is 
displayed on the chart to mark day (In Intraday mode) or year (In EOD mode) boundaries 

• Show vaiue iabeis - this decides If value lables for Indicator / price chart lines should be displayed. 
See basic charting guide for explanation what value label Is. 

• Candiesticks - this setting provides detailed control over the appearance of candlesticks. The distinct 
color may be used to draw part of the candlestick or entire candle may be drawn In the same color as 
Its Interior. 

• Drawing 

♦ Return to seiect mode after drawing - when checked current tool Is deactivated after 
drawing and select mode Is entered, when unchecked currently selected drawing tool remains 
active after drawing (allows to plot one study after another, note that the same effect can be 
achieved even If this box Is checked - It Is enough to hold down SHIFT key while drawing and 
the tool will remain active) 
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♦ Auto-select last drawn object - this useful feature automatically selects recently drawn 
object. This allows to hit ALT+ENTER to display properties box immediately without need to 
click on the study, and allows to Copy the study via CTRL+C also without additional click 

♦ Snap to price % threshold - defines how far price 'magnet' works, it will snap to price when 
the mouse is nearer than % threshold from H/L/C price 

• Miscellaneous 

♦ Ask for parameters of newly Inserted Indicators - when checked AmiBroker will 
automatically display Parameters window each time you insert new indicator or overlay one 
indicator over another. 

♦ Ask for confirmation when deleting Indicator sections - when checked AmiBroker will ask 
you to confirm deletion of any overlaid indicator section (applies to indicators created via 
drag-and-drop). Please note that deletion of indicator section modifies the underlying formula. 
More on this in Tutorial: Drag-and-drop 

♦ Max number of chart sheets - defines how many chart sheets (tabs) should be available. 
More information on chart sheets is in the Tutorial section here. Note that this setting will take 
effect after restart. 



Color tab - allows to define colors for particular chart element. 

The controls provide user definable color selection for charts, grid & background. 

Palette editor - allows to modify custom colors that can be referenced later via colorCustom0..colorCustom15 
constants 
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Editor tab - controls the appearance and features of AFL editor. 

• Use syntax highlighting - when checked editor automatically colorizes your code (different 
colors/styles for functions, constants, numbers, etc) 

• Auto-change case - when checked the function and reserved variable names are automatically 
capitalised so if you type bARSSince, editor will change it to BarsSince 

• Auto-complete - when checked you will be able to use auto-completion feature (CTRL-i-SPACE will 
auto-complete the word) 

• Parameter info - when checked the editor will display parameter information tooltip when you type a 
function name and opening brace 

• Highlight error line - when checked the formula editor marks the line of code that contains an error 
with a yellow background (Windows 2000 and XP only) 

• Copy As HTML - when checked the AFL editor on Edit->Copy / Cut command puts not only plain text 
and RTF formats to the clipboard but also HTML and DwHTML (Dreamweaver HTML) formats 
allowing pasting syntax-colorized code to Macromedia Dreamweaver and other HTML-aware 
applications. Note: rarely (on very few machines) turning this on may cause problems with pasting to 
Outlook. 

• Move edited files from Drag-drop to Custom folder - when checked the editor will automatically move 
manually edited formulas created by drag-and-drop mechanism inside hidden 'Drag-drop' subfolder to 
'Custom' subfolder. 

• Font settings - allows you to define AFL editor font face and size 

• Colors and styles - allows you to define what colors and styles will be used to mark certain language 
elements when syntax highlighting is ON. 
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Data tab - allows you to define default, global values for all databases. 

IMPORTANT: some of these settings may get overwritten by PER-DATABASE settings in File->Database 
Settings window. See explanation In Tutorial: Understanding database concepts. 

• Data source: defines default data souce (for databases that do not specify other source In 
Flle->Database Settings) 

• Local data storage: default setting for external databases (this setting gets overwritten by 
Flle->Database Settings). If "Enabled" then external data are cached In local files. If "Disabled" then 
local files do not store external data. 

• In-memory cache (max. symbols) - defines how many symbols data should be kept In RAM (for 
very fast access) - this works together with the next setting 

• In-memory cache (max. MegaBytes) - defines how many MB of RAM should be used for temporary 
data cache (for very fast access) 

• Number of bars to load - default setting for external databases (this setting gets overwritten by 
Flle->Database Settings). Defines how many bars should be loaded from external data souce and 
kept In AmiBroker. Examples: 10-years EOD: 2600, 60-days Intraday 1-minute: 30000 (approx) 

• Limit number of saved quotations - If this option Is ON AmiBroker will save database with limited 
number of quotations. This prevents the database from growing too much 

• Max. number of saved quotations - this Is the limit Itself. Preferable 300 or higher for EOD 
databases, 3000 or higher for Intraday 

• Defauit database path - this defines the path to the database that is ioaded on startup, if such 
database does not exist it wiii be re-created at startup time. 
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Intraday tab - provides settings for intraday charting 

• Custom time intervals - aiiow to define your own N-minute or N-hours intervais (avaiiabie iater from 
View->lntraday menu) 

• Custom N-tick chart settings - aiiow to define your own N-tick charts (avaiiabie iater from 
View->lntraday menu) 

• Align custom minute bars to regular market hours - when checked AmiBroker wiii trim pre-market 
custom intervai bar so new bar wiii begin exactly when trading hours start. Trading hours can be set 
per-database in File->Database Settings->lntraday settings. Let's say that we have 45-minute bars. 
Without this setting we would bet bars starting at 9:00, 9:45, 10:30, 11:15 etc. When this is turned on 
and trading starts at 9:30 we have guarantee that bars will be aligned to 9:30: 8:45, 9:30, 10:15, 11:00 

• Time compressed bars shows: 

♦ time of FIRST tick inside bar - when selected the bar gets the time stamp of the very first 
trade inside given time slot (bar) 

♦ time of the LAST tick inside bar - when selected the bar gets the time stamp of the very last 
trade inside given time slot (bar) 

♦ START time of the interval - when selected the bar is time-stamped with start time of the 
time slot (bar). Lets say that 30 minute bar covers 9:00:00..9:29:59. When this is selected 
AmiBroker will display time of this bar as 9:00 

♦ END time of the interval - when selected the bar is time-stamped with start time of the time 
slot (bar). Lets say that 30 minute bar covers 9:00:00..9:29:59. When this is selected 
AmiBroker will display time of this bar as 9:29:59 

• Realtime chart refresh interval - defines interval between automatic chart refreshes in real-time 
mode. By default charts are refreshed every 3 seconds but in very volatile market you may prefer to 
set it to 1, so charts are refreshed every second in real-time mode. 
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New in 4.90: To enable 'every tick' chart refresh in Professional Edition, go to Tools->Preferences, 
Intraday tab and enter ZERO (0) into "Intraday chart refresh interval" field, (note Standard Edition 
won't allow to do that). 

Once you enter zero, AmiBroker will refresh all charts with every new trade arriving provided that the 
formulasyou use execute fast enough. If not, it will dynamically adjust refresh rate to maintain 
maximum possible refresh rate without consuming more than 50% of CPU (on average). So for 
example if your charts take 0.2 sec to execute AmiBrokerwill refresh them on average 2.5 times per 
second. 

Note: built-in Windows Performance chart shows cumulated CPU consumption for all processes, to 
display PER-PROCESS CPU load use Sysinternals free software 
http://www.sysinternals.com/Utilities/ProcessExplorer.html 



• Price data tooltips 

if checked small tooltips will appear when you hover over the chart displaying selected bar date, 
prices / indicator values 

• Show interpretation in tooltip 

if checked data tooltips will include also interpretation text that is normally displayed in the 
Interpretation window. 

• Data tip auto-hide timeout 

defines how many seconds data tooltip should remain on the screen if you don't move your mouse. 

• Add full name to ticker in the ticker box 

when checked the ticker box displays not only symbol but also full name of the issue 
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• Add full name to ticker In the tree 

when checked the workspace tree displays not only symbol but also full name of the issue 

• Full-name tooltips In symbol tree 

when checked then full name of symbol is displayed in the tooltip that appears when you move your 
mouse over symbol in the symbol tree. 

• Data-tip auto-hIde timeout 

defines time in seconds how long data tooltip (that shows values of indicators) will be displayed when 
mouse cursor does not move 

• Thousand separator 

defines thousand separator for number displayed on charts and all list-views. 

• Decimal places In RT quote window 

defines how many decimal places should be displayed in Real Time quote window. 

• Axis font 

defines font face and size to be used for chart axis and text tool 

• No minimum size for resizing dialogs 

when checked it allows to size dialogs below the minimum size (so some controls become invisible) 

• Display plugin activity 

when checked AmiBroker displays information about accessing data plugin in the status bar 

• Case sensitive ticker symbols 

when checked ticker symbols are case sensitive. In other words INTO and Into and INTc are 
considered DIFFERENT. This is required for some Canadian symbols for example. Please use with 
caution. If your exchange do not use case-sensitive tickers please make sure it is UNCHECKED. 

• Auto-arrange charts 

if this option is on chart windows are scaled and arranged to fit the screen after every opening/closing 
chart window. 

• Auto-tile multiple chart windows 

when checked multiple chart windows are always tiled vertically on every resize of the main 
application window. 

• Ask to save changed data 

when checked AmiBroker asks if you want to save modified data on exit. When unchecked AmiBroker 
saves modified data without asking. 

• Save on exit: Preferences, Templates, Layouts 
controls which settings should be saved automatically on exit 
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Alerts tab - It allows to define e-mail account settings, test sound output and define which parts of AmiBroker 
can generate alerts via AlertIF function. 

E-mail settings page now allows to choose among most popular authorization schemes like: AUTH LOGIN 
(most popular), POP3-before-SMPT (popular), CRAM-MD5, LOGIN PLAIN. Version 5.30 allows also to use 
SSL (secure connection) used by GMail for example. For more information about setting up with GMail see 
Tutorial: Formula based alerts. 

Enable alerts from checkboxes allow you to selectively enable/disable alerts generated by Automatic 
analysis, Commentary/Interpretation and custom indicators. 

Keyboard tab 

- keyboard tab has been moved to Tools->Customize dialog 
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AFL tab 

• Multi-threaded charts - enables multi-threaded execution of AFL in charts/indicators. Multi-threading 
allows to maximize speed and utilisation of modern multi-core / multi-CPU computers. For example on 
8-core Intel i7 CPU your charts will run upto 8 times faster than in version 5.30. In version 5.40 the 
AFL engine has been completely rewritten from ground up to allow multiple instances of the engine 
running simultaneously. This enables not only multithreading but also enhances responsiveness of 
entire application, as even badly-written user formula used in a chart is not able to lock or slow the 
rest of the program. Multi-threading is ON by default. It can be turned off by unchecking this box but it 
is strongly discouraged. Multi-threading should be turned ON if you want AmiBroker to operate at full 
speed. 

• Catch system exceptions in indicators and commentaries - when checked all exceptions 
(run-time errors) are catched by the indicator drawing code, so no Bug Recovery window appears. 
Instead exception information is displayed inside chart pane. It is recommended to have this turned 
ON especially when you use real-time data 

• Stop parsing on first error - when checked parser stops further code analysis on first encountered 
error so only one (first) error is displayed in the formula editor error list. If it is unchecked then parser 
will list all errors found. It is recommended to turn it off. 

• Enabie ioop termination by Shift-BREAK - when checked AmiBroker will allow to break any for(), 
while() and do-while() loop by pressing and holding down SHIFT and BREAK(PAUSE) keys on your 
keyboard. 

• Check Shift+BREAK key every - defines how often keyboard state should be checked when loop is 
executed. Note that specifying small values will make loop execution slower. 

• Endiess ioop detection threshoid - defines the number of loop iterations after which AmiBroker will 
terminate the loop with "Possible Endless loop detected" error message. This is useful in situations 
when the code has infinite loop (due to mistake of the formula author) because it won't allow 
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AmiBroker to hang due to infinite iooping 

• Standard include path - the defauit path to use when #inciude statement uses < > braces instead of 

fifi 

• Formula tree root path - the root path of Formuia fiie/directory tree dispiayed in the Charts tab of 
Workspace window 

• Show hidden folders - determines if formula tree should show subfolders with "hidden" attribute 
(drag-drop folder is created as "hidden" by the setup program) 



Currencies tab 


This page allows to define base currency and exchange rates (fixed or dynamic) for different currencies. This 
allows to get correct backtest results when testing securities denominated in different currency than your base 
portfolio currency. For more details please check Tutorial: Pyramiding and multiple-currency support in the 
backtester. 

How does AB know whether I want the fixed or dynamic quote? 

There are following requirements to use currency adjustements: 

a) Symbol->lnformation, "Currency" field shows currency different than BASE currency 

b) Appropriate currency (defined in Symbol) has matching entry in Preferences->Currencies page 

c) the dynamic rate "FX SYMBOL" defined in the preferences EXISTS in your database and HAS QUOTES 
for each day under analysis range. 
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What is "INVERSE" check box for in the preferences? 

Let's for exampie take EURUSD. 

When "USD" is your BASE currency then EUR exchange rate wouid be "straight" EURUSD fx (i.e. 1.3). 

But when "EUR" is your BASE currency then USD exchange rate wouid be INVERSE of EURUSD (i.e. 1/1.3). 
Opposite wouid be true with FX rates iike USDJPY (which are aiready "inverse"). 
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Customize tools window 

This dialog allows you to customize the User Interface. It can be invoked from Tools->Customize menu. 
In "Tools" tab you define custom tool menu items: 



You can launch executable files (.exe), script files (.js, .vbs), web pages (.html) and any other registered file 
types from the tools menu. In order to add a new tool you should open this dialog and click "New" button. 
Then enter the tool name, command (by hand or using file dialog) optional arguments and initial directory. If 
you check "Prompt for arguments" checkbox AmiBroker will ask for program's arguments each time 

Version 5.60 brings new #import command that allows to import ASCII files from local disk or even from 
remote (web) sources. 

In the Tools->Customize, "Tools" page, you can now define custom tool that uses new #import command 
Command: #import 

Arguments: URL to download data from 
Initial dir: path to format definition file 

This functionality is used by the "Update US symbol list and categories" tool. 

Other tabs provide Ul customization features described in Customize Ul tutorial section. 

Keyboard tab 

The keyboard tab allows you to define your own keyboard shortcuts. 

To assign a shortcut key 

On the Tools menu, click Customize, and then click the Keyboard tab. 
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In the Categories list, select the menu that contains the command to which you want to assign the shortcut 
key. 

In the Commands list, select the command to which you want to assign the shortcut key. 

Put the cursor in the Press New Shortcut Key box, press the shortcut key or key combination that you want, 
and click Assign. 

If you press a key or key combination that is invalid, no key is displayed. You cannot assign key combinations 
with ESC, F1, or combinations such as CTRL+ALT+DEL that are already being used by your operating 
system. 

If you press a key or key combination that is currently assigned to another command and press "Assign" the 
error message will appear giving you choice to either cancel or re-assign the key shortcut to new command. 

To delete a shortcut key 

On the Tools menu, click Customize, and then click the Keyboard tab. 

On the Categories, and Commands lists, select the location for the shortcut key you want to delete. 

In the Current Keys list, select the shortcut key you want to delete and click Remove. 

To reset all shortcut keys to their default values 

On the Tools menu, click Customize, and then click the Keyboard tab. 

Click Reset All. 
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Symbol tree window 

In this windows we have got iist of available symbols and categories. Selecting one of them will refresh all 
opened charts and update information windows. This selection is global for the program i.e. all symbol 
functions will reference symbol selected in this window. 
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Watch lists represent 
user-defined grouping of 
symbols 

The list below shows 
symbols belonging to 
selected category 


Symbol 

S' Full name 


JPM 

MORGAN C... 


KO 

COCA COLA C... 


MCD 

MCDONALDS,,. 


Mice 

MMM 

3M COMPANY 



Symbols I Layouts | Layers Charts 


Symbols window is divided into three parts: 

a) search box 

b) category tree 

c) symboi iist 

The search box ailows to perform fuil text searches (including wildcard 
matching) against symbol and full name within selected category. So 
for example if you select "Technology" sector and type A* (letter 'A' and 
wildcard character *) the symbol list will show all symbols belonging to 
Technology sector with symbol or full name beginning with letter 'A'. 
Another example would be tping *-A0-FX - this will return all forex 
symbols on eSignal database (those ending with -AO-FX substring). 

The category tree (see the picture) shows different kind of categories. 

The symbol list (bottom part) shows the list of symbols belonging to 
selected category. The symbol list can be sorted by symbol or by full 
name. To sort just click on the header row of the list. Once you choose 
desired sorting order it will be kept for all subsequent category choices 
and searches. Also the order of columns can be changed so Full name 
column appears as first one. To re-arrange column, click on the column 
header, hold down the moust button and drag the column to desired 
location. Then release mouse button. 

Single symbol belongs to MANY categories at the same time. For 
example AAPL (Apple Inc.) will belong to: 

• Stocks group category 

• Nasdaq market category 

• Information sector category 

• Comp-Computer Mfg industry category 

and may also belong to several watch lists and favorites category. All 
at the same time. That's why one symbol will appear in many leaves of 
the workspace symbol tree. Now if you delete the SYMBOL it will of 
course disappear from ALL categories because you have deleted the 
symbol itself, not its assignment to category. 
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Information window 



This window aiiows you to dispiay and edit preferences of the symboi. 

• Symbol 

The short name, used in Seiect window and with quotation import functions, if you use them, 
piease check if ticker given in this fieid is the same as used in your quotation datasource 

• Alias 

The aiternative ticker name, it wiii be usefui if you e.g. get the reaitime quotes and backfiii from two 
separate datasources, that use different ticker names. 

• Full name 

Officiai version of firm name 

• Code 

Symboi code number 

• Web ID 

Symboi Web iD - can be used when you define Profiie view 

• Address 

Corporation address 

• Issue 

Totai number of shares 
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• Nominal value 

• Book value 

• Currency 


• Market 

Indicates which market the symbol belongs to. 

• Industry 

Indicates which industry the symbol belongs to 

• Group 

Indicates which Group the symbol belongs to. 


• Round lot size 

Various instruments are traded with various "trading units" or "blocks". For example you can purchase 
fractional number of units of mutual fund, but you can not purchase fractional number of shares. 
Sometimes you have to buy in 10s or 100s lots. AmiBroker now allows you to specify the block size 
on global and per-symbol level. 

You can define per-symbol round lot size in the Symbol->lnformation page . The value of zero means 
that the symbol has no special round lot size and will use "Default round lot size" (global setting) from 
the Automatic Analysis settings page. If default size is set also to zero it means that fractional number 
of shares/contracts are allowed. 

• Tick size 

This setting controls the minimum price move of given symbol. You can define it on global and 
per-symbol level. As with round lot size, you can define per-symbol tick size in the 
Symbol->lnformation page (pic. 3). The value of zero instructs AmiBroker to use "default tick size" 
defined in the Settings page (pic. 1) of Automatic Analysis window. If default tick size is also set to 
zero it means that there is no minimum price move. 

Note that the tick size setting affects ONLY trades exited by built-in stops and/or ApplyStop(). The 
backtester assumes that price data follow tick size requirements and it does not change price arrays 
supplied by the user. 

So specifying tick size makes sense only if you are using built-in stops so exit points are generated at 
"allowed" price levels instead of calculated ones. For example in Japan - you can not have fractional 
parts of yen so you should define global ticksize to 1, so built-in stops exit trades at integer levels. 

• Margin deposit - explained in Backtesting systems for futures contracts 

• Point vaiue - explained in Backtesting systems for futures contracts 


• Continuous quotations 

Enables continuous trading for this symbol (this enables candlestick charts and manual entry 
open/high/low/volume controls and candlestick charts), otherwise symbol is traded with price fixing 

• index 

Specifies if symbol belongs to /ndexes category. 

• Favourites 

Specifies if symbol belongs to Favour/fes category. 

• Use oniy iocai database for this symboi 

Indicates that symbol is not updated via the plugin in real-time database. This field is checked by 
default if the symbol is added into realtime database as a result of import from ASCII file (also 
AmiQuote download). This setting allows you to keep additional symbols in the database and prevent 
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plugin from overwriting the imported data. 

For explanation of Fundamental data fields please read "Tutorial: Using fundamental data" chapter of this 
guide. 


Information window 


338 


AmiBroker 6.00 User's Guide 


AmiBroker Reference Guide 


Notepad window 


Notepad window (that you can show/hide using Window->Notepad 
menu) that allows to store tree-text notes about particular security. Just 
type any text and it will be automatically saved / read back as you browse 
through symbols. Notes are global and are saved in "Notes" subfolder as 
ordinary 
text files. 

Notes can be also read and written to using AFL langauge NoteGet and 
NoteSet functions. 

NoteGet ( "Symbol" ) ; 

- retrieves note linked to "symbol". If symbol is "" (empty string) then 
current symbol is used 

NoteSet ( "Symbol", "Text..." ) ; 

- sets text of the note linked to "symbol". 

If symbol is "" (empty string) then current symbol is used. 

If you overwrite note from AFL level that is opened at the same time in 
Notepad editor the editor will ask you (when you switch the focus to it) if it 
should reload new text or allow to save your manually entered text. 

Example: 

NoteSet ( "AMD" , "Jun 15, 2004: AMD will deliver its 
first multi-core processors next year"); 
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Quote Editor window 



Quote Editor allows editing, deleting and adding quotes. 

To add new quote: 

- select (new) entry 

- enter date/time 

- enter price data 

- click on the list on the entry other than (new) 

To edit existing quote: 

- select quote from the list 

- edit price data 

- click on the list on the entry other than current 

To deiete existing quote(s): 

- mark one or more quotes (multiple selection possible by holding down SHIFT or CTRL key) 

- click "Delete" button 
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Symbol Finder window (F3) 



Stock finder window aiiows you to quickiy search the database for a symboi by typing the first ietters of its fuii 
name or ticker. This feature is very usefui when you don't know the ticker symboi. The symboi finder is 
accessibie via Edit->Find symbol, Symbol->Find menus or by pressing F3 key. 

To find a symboi just type one or more ietters in the Search for box. Choose by Name if you want to perform 
fuii name search or choose by Ticker if you want to look up for the ticker. When you type the letters in the edit 
box appropriate symbols will appear in the list. You can click on the item to choose one or you can just press 
ENTER key to select the first one. Note that searching starts when the edit box contains at least 1 character - 
if it is empty no symbol is shown in the list. 
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Using Web Research window 

Web Research window allows you to view on-line news, research, profiles, statistics and all kind of 
information related to currently selected symbol available over the Internet (World Wide Web). Using Web 
Research instead of plain web browser has speed advantage as you don't need to type complicated/long 
addresses (URLs) each time you need to get desired information. 

Web Research window introduced in version 4.90, replaces and enhances previously available Profile 
window. Now it allows unlimited number of user-definable web research (profile) pages, browsing to any web 
page (just type URL), tab-browsing, opening multiple pages at once, selective auto-synchronization. 

Web-Reasarch uses Internet Explorer engine so you can be sure that pages are rendered with the same 
quality you would get from stand-alone browser. 

OPEN NEW WEB RESEARCH WINDOW 


Use File->New->Web Research menu to create new web research window 
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PICKING PRE-DEFINED WEB RESEARCH PAGE: 


To display any pre-defined web research page, simply click on the drop down arrow in the Address 
combo-box and pick one item from the list. Once you do so, the web page relevant to currently selected 
symbol will be automatically displayed. 
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Now you can specify if and when dispiayed page shouid change automaticaily if you seiect different symbol. 


Qgo 
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The Sync button allows to decide when page should be automatically synchronized with currently selected 
symbol. 

• Don't sync - means that page should not be synchronized with currently selected symbol at all 

• Sync active - means that page should be synchronized ONLY when it is currently active or becomes 
active (by user clicking on given tab) - this is recommended setting for web-research profiles since it 
conserves bandwidth and resources (not active pages are not synchronized and do not consume any 
bandwidth) 

• Sync always - means that page is synchronized with currently selected symbol always, no matter if it 
is active or not. 

NAVIGATION 

Web Research window operates in a way very similar to stand-alone browser. To display any web page just 
type the URL address to "Address" field and press ENTER (RETURN) key. To navigate back and forward in 
the history use <- and -> buttons. 
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To close currently displayed page use regular window close X button as shown In the picture above 

DEFINING YOUR OWN WEB RESEARCH PLACES 


In addition to web-research pre-defined pages you can define any number of your own places. To do so use 

Tools->Customlze menu, Web Pages tab. 



To add new place press New button, then type the URL template In the URL field and web page description In 

the Description field. 

The URL template Is the web address In that has parts that depend on selected symbol. The URL template Is 
parsed by AmiBroker to make actual URL to the web page. For example to see Yahoo's profiles page you can 
use following URL template: 


http ://blz.yahoo.com/p/{tO}/{t}.html. 
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Symbols enclosed In brackets {} define fields which are evaluated In execution time. {tO} symbol Is evaluated 
to the first character of the ticker name and {t} Is evaluated to the whole ticker name. So If AAPL Is selected 
AmiBroker will generate following URL from above template: 

http://blz.yahoo.eom/p/a/aapl.html 

Then AmiBroker uses bullt-ln web browser (Web Research window) to display the contents of the page. 

Special fields encoding scheme 

As shown In above example template URL can contain special fields which are substituted at run time by 
values corresponding to the currently selected symbol. The format of the special field Is {x} where x Is 
describes field type. Currently there are three allowable field types: ticker symbol In original case {t}, ticker 
symbol In lowercase {s}, ticker symbol In UPPERCASE {S}, alias {a}, web Id {i}. You can specify those fields 
anywhere within the URL and AmiBroker will replace them with appropriate values entered In the Information 
window. You can also reference to single characters of ticker, alias or web Id. This Is useful when given web 
site uses first characters of, for example, ticker to group the html files (Yahoo Finance site does that), so you 
have files for tickers beginning with 'a' stored In subdirectory 'a'. To reference to single character of the field 
use second format style {xn} where x Is field type described above and n Is zero-based Index of the character. 
So {aO} will evaluate to the first character of the alias string. To get first two characters of a ticker write simply 
{tO}{t1}. Note about web Id field: this new field In Information window was added to handle situations when 
web sites do not use ticker names for storing profile files. I found some sites that use their own numbering 
system so they assign unique number to each symbol. AmiBroker allows you to use this nonstandard coding 
for viewing profiles. All you have to do Is to enter correct IDs In Web ID field and use appropriate template 
URL with {i} keyword. 

Pages stored iocaiiy 

You may want to have all pages stored on your local hard disk. This has an advantage that profiles are 
accessible Instantly but they can take significant amount of storage space and you will need to update them 
from time to time. To access locally stored files use the following template URL (example, C: denotes drive): 
flle://C:\the_folder_wlth_proflle_flles\{t}.html. You are not limited to HTML files, you can use simple TXT files 
Instead. Then create (or download) the .html (or txt) files for each symbol In the portfolio. These files should 
obey the following naming convention: <tlcker>.html. So for example for APPLE (ticker AAPL) the profile 
should have the name AAPL.html (or AAPL.txt) 

Web-based profiies 

If you want to display the profiles from remote web pages you will need to find out how they are accessible 
(the URL to the web page) and how the data for different symbols are accessible. I will describe the problem 
on the example of Sharenet (www.sharenet.co.za) site providing the data for companies listed on 
Johannesburg Stock Exchanges. Sharenet provides company Information that Is accessible at the following 
address (URL): 

http://www.sharenet.co.za/free/free_company_na.phtml?code=JSECODE&scheme=default 

The problem Is that database provided by Sharenet uses long ticker names and JSECODE Is a short symbol 
code. For example for "Accord Technologies" company the ticker In Sharenet database Is ACCORD but the 
code Is ACR. To solve the problem we will need to use Web iD field In the symbol Information window. If you 
have Sharenet database just choose the ACCORD from the ticker list, open Symbol->lnformation window and 
enter ACR to the Web iD edit box and click OK. Then enter the following URL template to the URL edit box: 
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http://www.sharenet.co.za/free/free_company_na.phtml?code={i}&scheme=default 

To be 100% sure please select the text above with a mouse. Then copy It to the clipboard (Edlt->Copy, 
CTRL-C). Then switch to AmiBroker and click on the Profile URL edit box. Delete everything from It and press 
CTRL-V (this will paste the text). Type "Sharenet" Into Description field. 

Please note that we have used {i} special field In the template that will be replaced by AmiBroker with the text 
entered In the Web ID field of the symbol Information window. Now please select File->New->Web Research 
and pick Sharenet from Address combo box. You should see the profile for ACCORD company. 

You can also delete any entry by selecting It from the list and pressing Deiete button. You can change the 
order In which pages appear In the Web Research address combo using Move Up and Move Down buttons 
(select the Item first and then use buttons). 

Configuration data are stored In webpages.cfg plain text file that holds any number of URL templates In the 
form of: 

URLTemplate|Descrlptlon 
(each entry In separate line) 
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Assignment organizer window 


In order to make assigning the symbois to categories simpier and faster a new assignment organizer was 
deveioped. Now you can simply mark a group of symbols and quickly move them from one category to 
another. 


You can also delete multiple symbols using this window. To do so, select one or more symbols from the 
left pane and click on "Delete" button. 



Assignment organizer window 
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Composite recalculation window 



This dialog allows automatic calculation of number and volume of advancing/declining/unchanged issues. 

Also possible in this dialog is calculation of volume numbers for indexes if imported incorrectly. Note well, that 
automatic recalculation of composite data makes only sense when you follow whole exchange (all symbols 
are included in your database) otherwise this calculation will give wrong results. 

In order to calculate the composites in the database it's necessary to set the base index for the market, as it 
may happen that not all stocks are quoted every businness day. AmiBroker checks the 'base index' quotations 
dates and tries to find the corresponding quotes of all the stocks belonging to that market, to find out how 
many issues advanced, declined and not changed at all. 

To calculate composities you need to: 

• Open Categories window using Symbol -> Categories menu item. 

• Select base index for given market in Markets tab and Base indexes for - Composites combo. 

For example if you are following NYSE this can by ^DJI (Dow Jones Average) ^DJI must be marked 
as index in Symbol -> Information and must belong to the same market. 

• Choose "Symbol ->Calculate composites" menu item to open the window shown below and mark : 
Number of advancing/declining issues and choose markets that you calculate composities for and the 
time range. 

• Click Calculate. 

There are also two additional fields available: 

• Volume for base index 

• Copy volume to all indexes 

These fields are provided in case you DON'T have real volume data for index quotes. In that case AmiBroker 
can calculate volume for index as a sum of volumes of all stocks belonging to given market. First option 
assigns calculated volume only to base index, the second copies the volume figure to all indices belonging to 
given market. 
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Categories window 



Markets 


Groups 

Sectors 

Industries 

Watch lists 


Name 

♦esei 

# NYSE 
^ Amex 

# Nasdaq 
OTC 

# Mutual funds 

# Markets 
^ Market 7 

# Markets 
tp Market 9 

# Market 10 

# Market 11 
^ Market 12 

A MarV»» 1? 


Settings; 


Relative strength; 


▼ 

Composites; 


▼ 

Beta; 


▼ 


URLs 

Profile; 

News; 


http; /^z. yahoo. com/p/{t0}( 


Edit name 


OK 


Cancel 


This dialog, allows you to define names of markets, groups, sectors and industries. For each market you can 
also define base indexes for calculating relative strength, composite data, beta or web profile URL. The 
detailed information about categories can be found in Understanding categories chapter of this manual. 

To Edit name of certain category, please select it from the list and press 'Edit name' button. 

Base indexs for fields allow you to set the index used in calculation of: 

• Relative Strength indicator 

• Composities via Composite calculation option 

• Beta 

Profile field allows you to define URL-template for viewing on-line (or off-line) companies' profiles. These 
URL-templates are market-based, what means you can have different templates for each market. The 
template is then parsed to create the actual URL to the web page, which will be displayed in an embedded 
web browser. To learn more read How to set up the profile view chapter. 


Categories window 
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ASCII Import Wizard 

ASCII Import Wizard provides an easy way to import your quotation data fiies as well as define your own 
import formats for future use. Note that wizard offers only a subset of features available in ASCII importer so it 
is provided for novice users only. 

The wizard guides you through 3 simple steps 

1. Picking the files to import 

2. Defining fields 

3. Additional settings 


Step 1. Picking the files 



In this step you select the files you want to import. Just click on the Pick files button and you will see a file 
dialog. Browse to the folder where your data files are located and select the file(s). Please note that you can 
select multiple files by holding CTRL or SHIFT key while clicking on the files. After making your selection 
please click Open 


A complete list of files that you have selected will be displayed in the field at the bottom of the wizard window. 
Please check if the list is correct, if not click "Pick files" to correct your choice. 


Step 2. Defining fields 
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In this step you define the types of fieids in the data fiie. For your convenience date fiie sampie is shown (a 
few first iines of the first seiected fiie) at the bottom of the window. 

To define fieids piease seiect appropriate fieid types from Column A/ combo-boxes. For exampie, if the first 
fieid (coiumn) in your data fiie is a symboi ticker piease seiect "Ticker" from Column 1 combo box. If second 
field in your data file is a date in Year-Month-Day format please select "YMD" from the second combo-box. 
You can select also DMY for Day-Month-Year dates, MDY for Month-Day-Year dates. Other field types 
available from the wizard are: "Open", "Close", "High", "Low" for the prices and "Volume". 

Note about the dates: AmiBroker recognizes both 4 digit and 2 digit year dates. As for months both numbers 
and three letter codes ("Jan", "Feb", ...) are allowed. Also day, month and year may be separated by any of 
the following characters: / (slash), \ (backslash), - (minus sign) or may not be separated at all. All you have to 
do is to specify the order: DMY, MDY, YMD. For example valid YMD dates are (31th December 2000): 

20001231, 

001231, 

2000-12-31 

2000/12/31 

2000-Dec-31 

00-12-31 

00/12/31 

00\12\31 

If your file has more than 7 columns please check More columns box and you will see additional 
combo-boxes. 

The remaining controls here are: 

Group: here you should select to which group new symbols are added 
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Watch list: here you should select to which watch list new symbols are added (If empty - they are not added 
to any watch list) 

Separator: here you should select the character used as a field separator (comma Is the most often) 

Skip lines: this tells AmiBroker how many Initial lines should be skipped (Ignored) - for example a few first 
lines of the file should contain a comment or other Information that should be Ignored, and this Is the place to 
define this 

Log errors: this tells AmiBroker that It should log all errors to the file (lmport.log). In case of any errors this log 
will be displayed to the user after finishing Import process. 

Automaticaiiy add new symbois: this tells AmiBroker to add the symbols that appear In the data file but do 
not exist yet In AmiBroker database. 

Caicuiate composites: this tells AmiBroker to calculate advance/decllne figures and volume for Indexes after 
Import (this requires composites to be set up properly before Importing) 

Aiiow negative prices: this tells AmiBroker to allow negative number In close, open, high, low fields. By 
default zero and negative values are NOT allowed. 

No quotation data: allows to Import data that do not contain prices. For example ticker lists and/or 
categories. 

Step 3. Additional settings 



By default the format you have defined Is for single-use only. It Is OK for novice users and for experimenting 
with the wizard. 
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If you, however, want to make your definition permantent and avaiiabie in the future via ASCII importer you 
shouid check Add current settings to ASCII importer definitions box. Then you shouid enter the Format 
description. File mask and Format file name (or you can accept automaticaiiy generated defauits). If you do 
so, you will be able to use the format defined in the ASCII importer window - just by selecting your own format 
(as typed in Format description field) from the "Files of type" combo of a file dialog. 

Whatever you decide, you should click "Finish" button in order to start importing your data. 


ASCII Import Wizard 
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Metastock importer window 

IMPORTANT NOTE: Metastock importer should be used ONLY if you want to import MS data to native, local 
AmiBroker database once. If you want AmiBroker to just read Metastock database DIRECTLY without need to 
import new data over and over please set up your database WITH METASTOCK PLUGIN as described in the 
Tutorial. 

NOTE 2: if you setup your database with the MS plugin you should NOT use Metastock importer, because 
there is no point in using it when your data are already fed by the plugin. 



Metastock importer opens AmiBroker to very rich source of historicai data. The importer supports both oid 
Metastock 6.5 and new 7.x (XMASTER) formats. 

Basicaiiy Metastock data consist of: 

• MASTER/EMASTER fiie which hoids generai information about the tickers, stock names, etc. 

• F1 .DAT....FXX.DAT fiies which hoid actuai quotation data 

The MASTER/EMASTER fiie is essential because it holds the references to Fxx.DAT files. Fxx.DAT files store 
only quotations in either 5 field (date/high/low/close/volume), 6 or 7 field 

(date/open/high/low/close/volume/openinterest) format. As you see MASTER/EMASTER and Fxx.DAT files 
are closely connected and you need them all to import the data. 

Usage 

To import Metastock data you should do the following: 

• Choose Metastock import Uom the menu 

• Using the directory requester (Browse...) select the location of data in Metastock format (the directory 
with MASTER/EMASTER and Fxx.DAT files) 

• After choosing proper directory AmiBroker will display the list of available symbols and date ranges. 

By default all available symbol will be marked for importing (checkmark at the beginning of the list). 
Now you can exclude some symbol from the import list by clicking appropriate item in the list 
(checkmark will toggle when you click). 


Metastock importer window 
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• You can decide to which group and watch iist the new symbois are added using Group and Watch 
List combos. 

• After making your seiections push 'Import' button to start the process of importation. 

• During the process you can cancei the operation by ciicking 'Abort' button in the progress window 


Metastock importer window 
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Using account manager 

Account manager is a tool for keeping track of your trades and your performance. You are able to enter trades 
you make, deposit/withdraw funds, check the statistics and historical performance. All transactions are 
recorded so you will never forget what happened in the past. Account manager allows you to keep track of 
unlimited number of accounts. 

New account manager replaces and enhances functionality provided by portfolio manager in pre-4.90 
versions. 

CREATE A NEW ACCOUNT 

Use File->New->Account menu to create new account 


A AmiBroker-DOWJONE 
^ File Edit View Insert 


□ 




H] New Database... 

10 New Default Chart 
Q New Blank Chart 
a New Blank Pane 


m 

New Account 

N 

e 

New Web Research 



er 

o\ 

vi 

»s1 

iv 

iti 


FUNDING AN ACCOUNT 

Before you do any trading, you have to fund your account. To do so press "FUNDING" button on the account 
manager toolbar, then select "Deposit" as operation type, enter the DATE when you have funded your 
account and enter the amount. 

Note that funding date must PRECEDE any trading, as account manager won't allow you to trade prior to 
funding date. Initial deposit will show as "initial equity" in summary tab. 


^ '^DJl (Daily V^Q Accountl x | 
^ Buy ▼ Sell j^Fundi^ S 



THE SETTINGS 

It is good idea to go to "Summary tab" and setup commissions and trading mode. If this account is used for 
End-of-day trading you should set "EOD Mode" to YES, otherwise (if you trade intraday) you should set "EOD 
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Mode" to NO. Depending on this setting Buy/Seii diaiogs wiii aiiowyou to enter date and time of the trade or 
oniy date. 



Commission tabie allows to enter both per-share (per-contract) commissions and commissions that are 
expressed as percent of trade value. Or a combination of both. You can also set minimums and maximums 
expressed in dollar amount and/or percent of trade value. For example if your broker may use 0.01$ (one 
cent) per share commission, then you would use PerShare = 0.01 and %OfTradeValue = 0. If your broker 
uses say 0.2% of trade value then you would use PerShare = 0 and %OfTradeValue = 0.2; 

Practical example: Interactive Brokers default commission for U.S. stocks is: 0.005 per share but not less than 
1 dollar and not more than 0.2% of trade value. Appropriate settings for such schedule are shown in the 
screenshot above. 

Commission table works as follows: first sum of per-share commission and % of trade value is calculated. 
Then the result is checked against minimum and maximum limits and if calculated value exceeds the limit 
then commission is set to value of such the limit, otherwise calculated value is used without change. 

Summary page contains a little bit of basic statistics as well. 
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ENTERING TRADES 

Once you funded an account you can enter trades.To buy (enter long position or cover short position ) click on 
"BUY" button. 


AOGF ^Accountl 


■i 

▼ Sen ©Funding 

ID 

Date/Time 

Type Symbol 


wr 


Ticker: 

Date: 

Price: 

Qty: 

Net market value: 
Commission: 
Margin deposit: 

Currency: 

FX rate: 



38.77 


500 

Set to Max. 

19385 

(futures only 

2.5 



(foreign /non-base/ 
currency not 
implemented yet) 


Then in the Buy dialog you need to select the symbol, the trade date/time. Once they are entered AmiBroker 
will display price of given symbol at the selected date/time (or preceding one if no exact match is found). It will 
also calculate maximum possible quantity taking price and available funds into account. 

You can change the price and quantity manually. 

All other values (net market valye, commission, market deposit, currency, fx rate) are calculated or retrieved 
automatically from Symbol->lnformation page. Once values are good, click OK to confirm transaction. If you 
made mistake, you can press UNDO (Edit->Undo) to revert last transaction. 

Similar procedure is for selling (entering short positions or closing longs) with the exception that you should 
press "SELL" button instead. 

All transactions that you made are listed in the "Transactions" sheet. All open positions are listed in "Open 
Positions" sheet. If you enter the trade for symbol that has position already open, AMiBroker will adjust "open 
positions" accordingly (perform scaling in/out). Once open position is closed it is removed from "open 
positions" list and moved to "Closed trades" sheet. 
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After each transaction, "Equity history" sheet is updated with current account equity vaiue and aiso 
"Summary" page is updated with basic open/iong/short trade stats.(More stats are to come). 

IMPORTANT 

You have to remember that you must enter aii transactions in chronoiogical manner(oidest first, newest last), 
as account manager won't allow you to add trades out-of-order. If you make mistake, there is one-level undo 
that you can use to revert to state before last transaction. If you made more mistakes, the only option is to 
close account without saving and re-open original file. 

SAVING YOUR ACCOUNT DATA 

To save edits made to account use File->Save (or File->Save As to save under new name). Note that 
account files are NOT encrypted now, and it is quite easy to read the file for everyone who has the access 
to it. So make sure not to leave your files on some public computer. Password protection/encryption is 
planned but NOT implemented yet. 

OPENING PREVIOUSLY CREATED ACCOUNT 

To open account file, go to File->Open, in the File dialog, select "Account (*.acx)" from "Files of type" 
combo-box, and select the account file you want to load. 
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MULTIPLE ACCOUNTS 

You can create/open multiple accounts at once (just use File->New->Account, File->Open many times). 
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Real-time quote window 


Working with reai time quote window 


The RT quote window provides reai-time streaming quotes and some basic fundamentai data. It is fairly easy 
to operate as shown in the picture below: 
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You can aiso dispiay context menu by pressing RIGHT mouse button over RT quote window. 
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48.10 

45. 

Type-in symbol(s) 

+4.12% 

28,220,481 


ADBE 

40.88 

41.53 

40. 

Insert empty line 

-0.36% 

3,645,325 

£ 

CNXT 

0.46 

0.47 

0.— 


-3.72% 

1,327,934 


LLTC 

35.95 

36.34 

35. 

Remove symbol 

-1.59% 

10,008,163 


QLGC 

15.52 

15.74 

15. ~ 

All 

-0.70% 

1,697,916 

1 

ADCr 

15.03 

15.37 

14. _ 

r\cn MJVc r\ll 

+0.00% 

2,586,111 

£ 

COMS 

2.40 

2.48 

2. 

Hide 

+0.41% 

2.773.398 

3^ 

i i V [hK List 1 /List 2) 

aist3yiist4'\ 

List 5 \ List 6 




List 12\ List l3\LiSt 


The context menu allows you to access the following options: 

• Time & Sales 

Opens Time & Sales window that provides Information about every bid, ask and trade streaming from 
the market. 

• Easy Alerts 

Opens Easy Alerts window that provides way to define realtime alerts executed when bld/ask/last and 
other fields hit user-defined levels 

• Add Symbol 

Adds current symbol to Real-Time Ouote list 

• Add watch list... 

Adds entire watch list to real-time quote window 

• Type-in symbols 

Allows to type the symbols directly as comma-separated list 

• Insert empty line 

Adds empty (separator) line - useful for grouping symbols 

• Remove Symbol 

Removes highlighted line (symbol) from the Real-Time Ouote list. 

• Remove All 

Removes all symbols from real-time quote list 

• Hide 

Hides Real-Time Ouote list 

Re-arranging symbols using drag-and-drop 

Real-time quote window now (v5.10 and up) allows you to re-arrange the list of symbols by drag-and-drop 
mechanism. Simply click the left mouse button over the symbol, hold It down and drag to desired location then 
release the button. 

Bid/ask trend indicator 


Last 

Change 

% Change 

Volume 

Trade size 

Bid/Ask Trend 

3.3940 

0.0149 

+0.44% 

13,465 

1 


1.2438 

-0.0036 

-0.29% 

91,126 

1 

llllllllll 

175.8000 

-0.2200 

-0.12% 

200 

200 

llllllllll 
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Version 5.90 adds Bid/Ask trend - a graphicai indicator showing the direction of 10 most recent changes in 
reai-time bid/ask prices. The right-most box is most recent and as new bid/ask quotes arrive they are shifted 
to the ieft side. Coior coding is as foiiows: 

• Dark green: bid > previous bid OR ask > previous ask 

• Bright green: bid > previous bid AND ask > previous ask 

• Dark red: bid < previous bid OR ask < previous ask 

• Bright red: bid < previous bid AND ask < previous ask 

• Red / Green box: ask < previous ask AND bid > previous bid 

• Green / Red box: ask > previous ask AND bid < previous bid 

If bid/ask prices don't change there is no new box. NOTE: This coiumn works oniy if there are reai-time quotes 
streaming (markets are open) 
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Easy alerts window 

Easy alert window allows to define real-time alerts without any coding. Please note that this functionality is 
available ONLY if you are using real-time data plugin and is not available in end-of-day mode. 



Adding new alert 

• press Add button 

• enter ticker symbol into Symbol field 

• choose price field from Field combo box 

• enter high trigger value and/or low trigger value 

• select at least one of the Text/Pop-up/E-mail/Sound fields 

Alert will be generated when selected price field (for example Ask) will become equal or greater than High 
value (if defined), or when selected price field will become equal or less than Low value (if defined). Alert once 
hit will not re-trigger until you press "Reset". 

Modifying an aiert 

Select one of listed alerts and modify values in the edit fields below. If you want to modify an alert that was hit 
already, after doing modifications please press "Reset" button 

Deieting aierts 

Select one or more alerts from the list (multiple selection possible by pressing down SHIFT key) and then 
press Deiete button. 

Resetting triggered aierts 

The alert that was once hit is market as "Hit high" or "Hit low" in the status field and becomes inactive (won't 
trigger anymore). If you want to re-activate it, select it from the list and press Reset button. 

Kinds of aiert output 
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• Text 

when this checkbox is marked, when aiert is triggered the text defined in comment fieid wiii be 
dispiayed in Aiert Output window (use Window->Aiert output menu to dispiay it) 

• Pop-up 

when this checkbox is marked, triggered aiert wiii display pop-up dialog box 

• E-mail 

when this checkbox is marked, triggered alert will send an e-mail to the account defined in 
Preferences/Alerts. 

• Sound 

when this checkbox is marked, triggered alert will play sound defined in Preferences/Alerts. 
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Time & Sales window 

NOTE: Standard Edition is limited to 1 time & sales window, Professional Edition allows UNLIMITED number 
of time & sales window open simultaneously. 

Time & Sales window that provides information about every bid, ask and trade streaming from the market. 
Each row displayed represents either new trade, new bid or new ask that is sent by the streaming data 
source. 



Each line in time and sales window is marked with color to make it easier to distinguish between various 
conditions. 

Coloring rules are: 

• light green background means NEW ASK 

• light red background means NEW BID 

• normal (white) background means NEW TRADE 

• Red text for bid/ask price/size means that the value is LESS than previous value of the same category 
(for example bid price written in red letters mean that the new BID is lower than previous bid price, 
green volume field means that the volume of last trade or ask/bid size is greater than last trade 
volume or ask/bid size) 

• Red last trade price means trade occuring on or below current bid 

• Green text for bid/ask price/size means that the value is GREATER then previous value. 

• Green last trade price means trade occuring on or above current ask. 

• Black text for bid/ask price/size/volume means that the value is the same 

• Black last trade price means trade occuring inside current bid-ask range (greater than bid and less 
than ask) 

Time&Sales window in version 5.30 shows some "recent statistics" regarding trading namely: 

• number of trades and average # of trades per second 

• number of trades and shares traded at ask or above 

• number of trades and shares traded at bid or below 

• ask minus bid difference expressed in number of trades and shares 

• ask minus bid difference expressed as percentage ratio to total trades/total volume traded 
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A little background: 

Ask minus bid: the positive numbers represent more transactions occuring on ASK side than on BID side. This 
in theory may mean more buying than selling, but in practice things are largely dependent on security traded. 
Esp. dark liquidity pools do not show in order books and may report trades to the tape several seconds later 
thus invalidating relationship between bid/ask and actual trade prices. 

IMPORTANT: 

These are temporary, short-term stats - they cover ONLY trades displayed in the T&S window since opening 
of the window OR 
resetting stats. 

You can reset statistics using right click menu : "Reset Stats" 
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Bar Replay window 

Bar Replay tool Is available from Tools->Bar Replay menu. Bar Replay feature plays back data for all 
symbols at once with user-defined speed. It means that data for all symbols will end at specified "playback 
position". This affects all formulas (no matter If they are used In charts (Indicators) or auto-analysis). 



Controls description 

Navigation bar: 

. 1^ - Rewind to the beginning 

• i - one Step Back 

• ■ - Stop - turns bar replay OFF (chart are not affected by bar reply) 

• II - Pause - pauses current playback or enters pause mode that allows to manually drag the slider 

bar and affect chart display - In PAUSE mode data are Internally modified so quotes past selected 
"playback" position are Invisible to any part of AmiBroker ( charts / automatic analysis ), except 
quotation editor 

• ► Play - Play - playback bars history 

• ► - one Step Forward 

. m - Forward to end of selected range 

Slider bar - allows to see the playback progress as well as MANUALLY move back and forward by dragging 
the slider thumb. 

Start/End - controls provide start and end simulation dates. The playback works so that all data upto currently 
selected "Playback position" are visible. Data past this position are Invisible. "Playback position" can change 
from user-defined "Start" to "End"dates. The small ^ buttons on the right side of Start / End date fields allow to 
set Start/End to currently selected date on the chart. 

Step interval - defines Interval of the step. Recommended setting Is base Interval of your database. So If you 
have 1-minute database, step Interval should be 1 minute. If you have EOD database, step Interval should be 
dally, however It Is allowed to select higher step Intervals. Note that chart viewing Interval Is Independent from 
that. So you can playback 1 minute database and watch 15 minute bars (they will look like real - building last 
"ghost" bar as new data come In) 

Speed parameter defines step frequency. It means how many steps will be played back within one second. 
Default Is 1. Maximum Is 5 minimum Is 0.1. If you select 3 for example, AmiBroker will play one step every 
0.333 sec giving total of 3 steps per second. 
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Skip afterhours - when turned on, playback skips hours outside regular trading hours as defined in 
File->Database Settings->lntraday Settings 

Skip weekends - when turned on, playback skips Saturdays and Sundays 

Usage 

To ENTER Playback mode - press PLAY ► or PAUSE II buttons - then data are truncated at current 
"playback position". 

To EXIT Playback mode - press STOP ■ button or close Bar Replay dialog - the full data set will be 
restored. 

Note that playback simulation is done internally and the database is kept untouched in fact (all data are still 
visible in Quote Editor), so there is no risk using Bar Reply. 
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Formula Editor 

A new AFL Formula Editor features: 

• Syntax highlighting (improved in 5.80) 

• Automatic brace matching/highlighting (NEW in 5.80) 

• Auto indentation (NEW in 5.80) 

• Indentation markers (NEW in 5.80) 

• Enhanced auto-complete in two modes (immediate (NEW in 5.80) and on-demand) 

• Parameter information tooltips 

• Line numbering margin and selection margin (NEW in 5.80) 

• Code folding (NEW in 5.80) 

• In-line Error Reporting (NEW in 5.80) 

• New tabbed user interface with ability to work in both MDI and separate floating frame mode, can be 
moved behind main AmiBroker screen and brought back (Window->Toggle Frame) (NEW in 5.80) or 
kept on top (Window->Keep on top) 

• Rectangular block copy/paste/delete (Use mouse and hold down left Alt key to mark rectangular 
block) (new in 5.80) 

• Auto capitalisation (change case) 

• Virtual space (new in 5.80) 

• Enhanced printing (with syntax highlighting and header/footer) 

• Code snippets (new in 5.80) 

These features greatly simplifies writing formula and provides instant help so time needed to write formula decreases significantly. 



Menu 
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Formula Editor menu options are described in detail in Menus: Formula Editor chapter of the guide. 

Toolbar 



The Formula Editor toolbar provides the following buttons: 

• New - clears the formula editor window 

• Open - opens the formula file 

• Save - saves the formula under current name 

• Print - prints the formula 

• Cut - cuts the selection and copies to the clipboard 

• Copy - copies the selection to the clipboard 

• Paste - pastes current clipboard content in the current cursor position 

• Undo - un-does recent action (multiple-level) 

• Redo - re-does recent action (multiple-level) 

• Formula Name - an EDIT field that allows to modify the formula file name, once you change the 
name here and press Save button the formula will be saved under new name and the change will be 
refleced in editor CAPTION BAR and in the STATUS BAR (Status bar shows full path). 

• Check syntax - checks current formula for errors 

• Apply indicator - saves the formula and applies current formula as a chart/indicator ONCE 

• Analysis - saves the formula and selects it as current formula in Automatic Analysis window and 
repeat most recently used Analysis operation (i.e. Scan or Exploration or Backtest or Optimization) 

Usage 

Typical use of Formula Editor is as follows: 

• open Formula Editor 

• type the formula 

• type meaningful name that describes the purpose of you code into Formula Name field 

• click Apply indicator button (if you have written indicator code) 

.. or.. 

click Analysis button to display Automatic Analysis window (when you have written exploration/scan 
or trading system) 

Syntax highlighting 

AmiBroker's AFL editor features user-definable syntax highlighting that automatically applies user-defined colors and styles to 
different language elements like functions and reserved variable names, strings, numbers, comments, etc. This feature greatly 
simplifies code writing. You can modify coloring scheme in Preferences window. 
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Enhanced error reporting 

When you make an error in your formula, AmiBroker's enhanced error reporting will help you to locate and fix 
an error by highlighting the place where error occured and displaying extended error description with the 
examples of common mistakes and advice how to fix them. In version 5.80 description of errors are displayed 
in-line with the code. 

A message bar displays total number of errors and/or warnings. If you press "Go to error" button the editor 
will move the caret to the relevant line with the error, if you press it again, it will move to the next error and so 
on. If you close the message bar with the "X" button all error messages will be cleared (hidden) from the view. 
You can use Edit->Clear Error Message menu (Ctrl+E) to clear individual error message (in the current line). 



Context help 

You can quickly display relevant AFL function reference page if you press F1 key or choose "Function 
reference" from the context menu while the caret is inside or right after function name as shown in the picture 
below: 
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Automatic statement completion 


The automatic completion feature (available when you press CTRL+SPACE key combination) finishes typing 
your functions and reserved variables for you, or displays a list of candidates if what you've typed has more 
than one possible match. You can select the item from the list using up/down arrow keys or your mouse. To 
accept selection press RETURN (ENTER). You can also type immediately space (for variables) or opening 
brace (for function) and AmiBroker will auto-complete currently selected word and close the list. To dismiss 
the list press ESC key. 
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tr = Trough( Close, Change )j 




pkbars = PeakBars( Close, Change 
trbars = Tro( Close, Change )j 


f TimeNum 
id Title 
id ToolTip 
f Trin 
f Trix 

> 

f 1 


f TroughBars 


id True 


f TSF 


typeof 

- 


)i 


Auto-complete box 

It works in two different modes: 

a) on-demand - it is displayed when you press CTRL+SPACE 

b) immediate - it is displayed automatically after you type 
first character 

In both modes the auto-complete box displays a list of 
matching keywords/functions and you can accept the entry 
by pressing ENTER or TAB keys. 


Parameter Information 

When you are typing a function, you can display a Tool Tip containing the complete function prototype, 
including parameters. The Parameter Info Tool Tip is also displayed for nested functions. 

With your insertion point next to a function, type an open parenthesis as you normally would to enclose the 
parameter list. 

AmiBroker displays the complete declaration for the function in a pop-up window just under the insertion point. 
Typing the closing parenthesis dismisses the parameter list. 

You can also dismiss the list if you press arrow up/down key, click with the mouse or press RETURN. 
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0 AFL Formula Editor - [Formula 49.afl] 


: File Edit View Tools Window Help 
l%ie|> 00 .| Formula49 


Formula 48.afl 


►^Apply " ^ ^ _ 



Formula 49^fl x 


tr = Tr-ough( Close, Change ); 


pkbars = PeakBa''5( Close, Change ); 
trbars = T'-cughBa''s( J 

TroughBars(^RRAX%changej^^Nth^=^^2J 



Parameter information tip 

Type opening brace ( after function name and 
parameter information tip will appear 


Editor configuration 

The settings of the AFL editor can be changed using Toois->Preferences, Editor page: 



Data 

Intraday Miscellaneous Alerc 

AFL 

Currenaes 

Charting 

Axes / Grids | Colors 

Bars & Candles 

Editor 


General 

[V] Auto change case [V] Copy as HTML 
M Parameter Info 

13 Virtual space [v] Use separate frame 

13 Move edited files from Drag-drop to Custom folder 
Font settings 
|Consolas, 10 pt 

Colors & styles 
I Background ^ 



Auto-complete: 
© Disabled 
© On-Demand 
@ Immediate 


Choose... 


OBold 

□ Bold 

□ Bold 

□ Bold 

□ Bold 
[3 Bold 

□ Bold 


OK 


Cancel 


Apply 


Help 


• Auto change case - controis whenever editor automaticaiiy changes case of reserved keywords (for 
example if user typed valuewhen it would change it to ValueWhen) 

• Parameter info - controls whenever parameter info tips are displayed 
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• Virtual space - controls whenever it is possible to place the caret freely in any place after the end of a 
line 

• Move edited files from drag-drop to custom folder - normally formulas created by drag-drop 
mechanism are located in hidden drag-drop folder, if you then want to edit them, you can do so in 
place so they remain in drag drop (hidden) folder, or you may choose to move them automatically to 
'custom' folder. This switch enables automatic move to custom folder 

• Copy as HTML - enables copies in HTML format so AFL code is copied with colors, without it it will be 
copied as plain text without formatting 

• Use separate frame - if turned on it displays AFL Editor in completely separate frame that behaves 
like separate application, if it is turned off, then AFL editor is displayed as a MDI tab within main 
AmiBroker frame (along with charts, analysis windows, web, account windows and so on). By default 
it is turned on 

• Auto-complete: in "On-demand" mode auto-complete list shows up only when you press 
Ctrl+SPACE, in "Immediate" mode auto-complete list pops up automatically as soon as you type first 
character (letter) of the identifier. 


Window control 


(Tl AFL Formula Editor - [Formula 49.afi]: 


L : File Edit View Tools 

Window Help 

M □ y ^ ^ 

Toggle Frame | 

1 Formula 48.afl 

Keep on Top | 

tr = Trough( C' 

^ Cascade 


H Tile Horizontally 

pkbars = PeakB; 


trbars = Trougl] 

^ Tile Vertically 


1 Formula 48.afl 


v" 2 Formula 49.afl 


I ►SApply 


AFL Editor Window as a separate frame can be brought on top or to the back as any other application window 
using Windows Task Bar. In addition to that there is a Window->Toggle Frame menu (and Ctrl+' shortcut,' 
is the tilde key just above TAB key on most keyboards) that allows to quickly toggle between AmiBroker main 
frame and AFL editor frame. 

The user may also turn on Window->Keep On Top feature that keeps editor window on top of AmiBroker 
main frame. 

Margins 
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0 AFL Formula Editor - [Formula 49.afl] 


\ File Edit 

Vie 

Tools Window 

Formula 48.a 


Fold All 

Unfold All 

tr 


Line Numbers 

pk 

tr 

✓ 

Selection Margin 

V* 

Fold Margin 


Help 

la 49 ►aApply " ^ _ 



2 ); 

Change )j 




Toolbars ► 


Line numbers margin, Seiection margin and Foid margin can be switched on/off using View menu. In this 
menu there are also options to fold/unfold all code. 

Code snippets 

Code snippet is a small piece of AFL code. It can be inserted by: 

• right-clicking in the AFL editor window and choosing "Insert Snippet" menu, or 

• dragging a snippet from Code Snippet window, or 

• typing keyboard trigger (such as @for) in the editor 


0 AFL Formula Editor - [Formula 46.afl] 




File Edit View Tools Window Help 
DQ^B! ioo< Formula 46 


►gApply » ^ 


Formula 46.afl X 


Insert Snippet t 

Charts r 



Cut 

Composites ► 



Ccc;. 

Conditional ► 



Paste 

Custom backtest r 

CBT Hi-level 

X 

Delete 

File r 

CBT Hi-level + trade list 

m 

Unde 

Loops r 

CBT Mid-level 

ra 

Redo 

Position sizing ^ 

CBT Low-level 


jtlect «ll 

Static variables ► 

Custom metric simple 

K 


Find 

Stops ► 

Per-trade custom rlr^ric 


Print 

Parameter info 

Function reference 

Trading system ► 

User category ► 






For more information about Code snippets see Tutorial: Using Code-snippets 
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Quick review window 



This window provides overaii market information iike: 

• daiiy symboi quotes 

• weekiy returns comparison tabie 

• monthiy returns comparison tabie 

• quarteriy returns comparison tabie 

• yeariy returns comparison tabie 

• Price/Earnings comparison 

• Price/Book vaiue comparison 

in the Date fieid you seiect the base date for comparisons. For exampie weekiy returns are caicuiated by 
dividing base day ciose price with the ciosing price one week before. 

Filter button aiiows you to narrow down your search to symbois defined in Fiiter settings window. 
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Automatic analysis window 


A Automatic Analysis - Unnamed 184.afl 
Formula file 

Formulas\CustomVJnnamed 184.afl 


Pick 


Edit 


Apply to 
O all symbols 
current symbol 
« use filter 


Define... 


n Run every; 5mln 

n Walt for backfill (RT only) 

O Sync chart on select 
Results - 


Range 

'?'• all quotations 
© n last quotations 
n last days 

a from; 2006-01-01 
to; 2007-12-01 


Scan 


Explore 


7 

□ - 
□ - 


Back Test i 


Report.. 


optimize 

▼ 

Rte 

▼ 


Eguity 


Settings... 


Parameters 


Close 


0 


Ticker 

Trade 

Date 

Price 

Ex. date Ex. Price 

% chg 

Profit % ' 

ADM 

Short 

2006-01-03 

24.38 

2006-01-04 

25.92 

6.32% 

-631.67 -< = 

ABV 

Long 

2006-01-04 

39.51 

2006-01-20 

39.82 

0.78% 

73.51 C" 

ABD 

Short 

2006-01-20 

24.32 

2006-02-24 

23.9 

-1.73% 

163.06 

AAV 

Long 

2006-02-24 

19.96 

2006-02-27 

19.75 

-1.05% 

-101.05 -: 

AAV 

Short 

2006-02-27 

19.75 

2006-03-15 

19.6 

-0.76% 

72.18 C 

AAV 

Long 

2006-03-15 

19.6 

2006-04-05 

19.09 

-2.60% 

-249.17 -: 

AAI 

Short 

2006-044)5 

17.93 

2006-05-10 

14.12 

-21.2... 

1981.89 2: 

AAI 

Long 

2006-05-10 

14.12 

2006-05-12 

13.28 

-5.95% 

-672.76 -: - 



nr 





► 

<35 rows) Profit = 5322.05 (53.22%), CAR = 25.08%, MaxSysOD 

= -2567.19 (-18.90%), CAR/MDD = 1.3 


Automatic analysis window enables you to check your quotations against defined buy/sell rules. AmiBroker 
can produce report telling you if buy/sell signals occurred on given symbol in the specified period of time. It 
can also simulate trading, giving you an idea about performance of your system. 


In the upper part of window you can see the path to the formula used along with Pick and Edit buttons. 


Pick button opens up a file dialog that allows you to choose the formula you want to use for the analysis. 

Edit button opens up the AFL Formula Editor that allows you to edit currently selected formula. 

If you want to create new formula just open Formula Editor directly from Tools->Formula Editor menu, type 
the formula and press Anaiysis button in the Formula Editor toolbar. 


In the formula editor you need to write the code that specifies either scan/exploration you want to run or a 
trading system you want to back test. You can find the description of this language in AFL reference guide. 

In order to make things work you should write two assignment statements (one for buy rule, second for the 
sell rule), for example: 


buy = cross( macd(), 0 ); 
sell = cross( 0, macd() ); 

Below these fields there are several controls for setting: 

1. To which symbol(s) analysis should be applied. 

You can select here all symbols, only currently selected symbol (selected in Select Window) or 
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custom filter setting 

2. Time range of analysis 

analysis can be applied to all available quotations or only to the defined number of most recent 
quotations (or days) or to a date range (from/to) 

In the lower part of the analysis window you can see 4 buttons: 

1. Scan 

this starts the signal scan mode - AmiBroker will search through defined range of symbols and 
quotations for buy/sell signals defined by your trading rules.If one of the buy/sell conditions is fulfilled, 
AmiBroker will display a line describing when and on which symbol the signal has occurred. Next 
AmiBroker proceeds to the end of the range so multiple signals on single symbol may be generated. 

2. Explore 

this starts an exploration mode when AmiBroker scans through database to find symbols that match 
user-defined filter. The user can define output columns that show any kind of information required. For 
more information please check out "Tutorial: How to create your own exploration" 

3. Back Test 

this starts the back-testing mode - AmiBroker will search through defined range of symbols and 
quotation for BUY signal defined by your buy rule. If the buy rule is fulfilled, AmiBroker will "buy" 
currently analyzed shares. Next it will search for SELL signal. Then, if sell rule is fulfilled, AmiBroker 
will "sell" previously bought symbols. At the same time it will display the information about this trading 
in the listview. After performing simulation the summary will be displayed. Read more in "Tutorial: 

How to backtest your trading system"... 

The back testing parameters could be changed using Settings window. 

4. Settings - allows you to change back tester settings 

5. Optimize - allows you to optimize your trading system. Read more in the "Tutorial: How to optimize 
your trading system"... 

6. Check - this option allows you to check if your formula references future quotes. AmiBroker analyses 
your formula and detects if it uses quotes past current bar. Please note that formulas referencing 
future can give unrealistic backtesting results that can not be reproduced in real trading, therefore you 
should avoid systems that reference future. 

7. Report 

this displays Report window that allows you to watch, print and save test results 

8. Equity 

- available only after backtesting - displays Equity curve for currently selected symbol in a new chart 
pane. Check out "AFL: Equity chart and function". 

9. Export - allows you to export the results to CSV (comma separated values) file 

10. Close 

this closes the analysis window 

Moreover you two options "Load" and "Save" for loading and saving your trading rules from/to files. 

Enlarging results view in Automatic analysis window 

There is a small arrow button next to the "Result list" horizontal divider line. This button is provided to 
enlarge/shrink the result list. When you are editing your formula it is good to have edit view larger, but to see 
the backtesting results it is convenient to enlarge the result list. In that case just click on that button and the 
result list will be enlarged (and the edit field will get shrinked). To do the reverse just click the button again. 
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Filter settings window 

This window is avaiiabie from "Fiiter/Define..." button in quick-review and anaiysis windows. 

Fiitering option gives you abiiity to narrow your search to symbois beionging to the specified market, group, 
sector and industry. You can aiso mark to inciude oniy favourites or indexes. You can use inciude and/or 
exciude type fiiter so you can aiso seiectiveiy exciude some kind of symbois . 

if you use more than one category (for exampie you seiect Market and Sector) the fiiter wiii pass oniy those 
symbois that match first AND second category (this iogicai conjunction, not aiternative) 
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System test settings window 



Here you can define the following parameters of back-testing: 

General tab 

Initial equity - defines the size of your account. In Portfolio backtest - it represents entire portfolio size. In 
"Individual" backtest it is per-symbol initial equity. 

Pos/f/ons considered (long, short, both long and short) 

Futures mode 

This check box in the settings page is the key to backtesting futures. It instructs backtester to use margin 
deposit and point value in calculations. 

Min. shares 

The minimum number of shares that are allowed to buy/short. Backtester will not enter trades below that limit. 
Should be 1 for stocks. Fractional values are good for mutual funds. 

Min. pos value 

The minimum position value (in base currency) of the trade that is allowed to be entered. Backtester will not 
enter trades below that limit. Zero means no limit. 

Pad and align to reference symbol 
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When this is turned on, aii symbois' quotes are padded and aiigned to reference symboi. Note: by defauit this 
setting is OFF. Use responsibiy. It may siow down backtest/expioration/scan and introduce some siight 
changes to indicator vaiues when your data has hoies and hoies are fiiied with previous bar data. The feature 
is intended to be used when your system uses generai market timing (generates giobai signais based on data 
and/or indicators calcuiated using Foreign from 'reference' symbol) or when you are creating composites out 
of unaligned data. Note: if reference symbol does not exist, data won't be padded. 

Account margin 

This setting defines percentage margin requirement for entire account. The default value of Account margin is 
100. This means that you have to provide 100% funds to enter the trade, and this is the way how backtester 
worked in previous versions. But now you can simulate a margin account. When you buy on margin you are 
simply borrowing money from your broker to buy stock. With current regulations you can put up 50% of the 
purchase price of the stock you wish to buy and borrow the other half from your broker. To simulate this just 
enter 50 in the Account margin field (see pic. 1). If your intial equity is set to 10000 your buying power will be 
then 20000 and you will be able to enter bigger positions. Please note that this settings sets the margin for 
entire account and it is NOT related to futures trading at all. In other words you can trade stocks on margin 
account. 

Commissions 

• commission tabie - backtester will use commission table as defined in Commission Schedule table 
window (press Define... button to show it). 

• percent - commission is expressed as a percent of trade value 

• $ per trade - commission is fixed amount of dollars (or your currency) per trade 

• $ per share/contract - commission is expressed in dollars (or your currency) per share/contract 
purchased/sold 

Annual interest rate 

This setting allows you to define annual interest earned when you are out of the market or your position is less 
than available equity. 

Periodicity 

This setting controls bar interval used for backtesting/scan/exploration/optimization. To backtest intraday data 
you should switch to proper interval there and then run the backtest. 

Allow position size shrinking 

If you mark this box AmiBroker will shrink down positions if available equity is less than requested position 
size (via PositionSize variable). If this box is unmarked positions will not be entered in such case. 

Activate stops immediatelly 

When you trade on open and want to have built-in stops activated on the same bar - just mark this box. 

If you trade on close and want built-in stops to be activated from the next bar - unmark this box. 

You may ask why do not simply check the buyprice or shortprice array if it is equal to open price. 
Unfortunatelly this won't work. Why? Simply because there are doji days when open price equals close and 
then backtester will never know if trade was entered at market open or close. 
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Round lot size 

Various instruments are traded with various "trading units" or "biocks". For exampie you can purchase 
fractionai number of units of mutuai fund, but you can not purchase fractionai number of shares. Sometimes 
you have to buy in 10s or 100s iots. AmiBroker now aiiows you to specify the biock size on giobai and 
per-symboi ievei. 

You can define per-symboi round iot size in the Symboi->lnformation page. The vaiue of zero means that the 
symboi has no speciai round iot size and wiii use "Defauit round iot size" (giobai setting) from the Automatic 
Anaiysis settings page. If defauit size is set aiso to zero it means that fractionai number of shares/contracts 
are aiiowed. 

You can aiso controi round iot size directiy from your AFL formuia using RoundLotSize reserved variabie, for 
exampie: 

RoundLotSize = 10; 

Tick size 

This setting controis the minimum price move of given symboi. You can define it on giobai and per-symboi 
ievei. As with round iot size, you can define per-symboi tick size in the Symboi->lnformation page. The vaiue 
of zero instructs AmiBroker to use "defauit tick size" defined in the Settings page of Automatic Anaiysis 
window. If default tick size is also set to zero it means that there is no minimum price move. 

You can set and retrieve the tick size also from AFL formula using TickSize reserved variable, for example: 

TickSize = 0.01; 

Note that the tick size setting affects ONLY trades exited by built-in stops and/or ApplyStop(). The backtester 
assumes that price data follow tick size requirements and it does not change price arrays supplied by the 
user. 

So specifying tick size makes sense only if you are using built-in stops so exit points are generated at 
"allowed" price levels instead of calculated ones. For example in Japan - you can not have fractional parts of 
yen so you should define global ticksize to 1, so built-in stops exit trades at integer levels. 

Reverse entry signal forces exit 

When it is ON (the default setting) - backtester works as in previous versions and closes already open positon 
if new entry signal in reverse direction is encountered. If this switch is OFF - even if reverse signal occurs 
backtester maintains currently open trade and does not close positon until regular exit (sell or cover) signal is 
generated. 

In other words when this switch is OFF backtester ignores Short signals during long trades and ignores Buy 
signals during short trades. 

Allow same bar exit (single bar trade) 

When it is ON - entry and exit at the very same bar is allowed, when it is OFF then exit may occur only on 
bars following the entry bar. You may turn "Allow same bar exit" option ON only if you are entering trades on 
OPEN. If you are entering trades on any other time than bar's open, this option should be turned off to avoid 
looking into the future. 
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Use QuickAFL 

QuickAFL(tm) is a feature that allows faster AFL calculation under certain conditions. Initially (since 2003) it 
was available for indicators only, as of version 5.14+ it is available in Automatic Analysis too. 

Initially the idea was to allow faster chart redraws through calculating AFL formula only for that part which is 
visible on the chart. In a similar manner, automatic analysis window can use subset of available quotations to 
calculate AFL, if selected “range” parameter is less than “All quotations". 

Detailed explanation on how QuickAFL works and how to control it, is provided in this Knowledge Base article: 
http://www.amibroker.eom/kb/2008/07/03/quickafl/ 

Note that this option works in the backtester/optimizer, explorations and scans. 

Trades tab 

• prices buy/sell/short/cover price fields - allows the user to define at which price to buy/sell/short 
sell/buy to cover during system test 

• delays buy/sell/short/cover delay - allows to define custom delay between signal and trade 

Stop tab 

• max. loss stop 

• profit target stop 

• trailing stop 

• N-bar stop 

See APPLYSTOP function for more details on different stop settings 
Report tab 
Result list shows 

This decides which format of result list is used by new backtester. Possible choices: 

• Trade list (the default) - each trade is listed in a separate row. Trades are ordered by exit date by 
default 

• Detailed log - each data bar is listed separately. The log shows scores, positions and other very 
detailed information useful for debugging your trading system/position sizing/scoring strategies 

• Summary - one row per backtest is generated. The row contains backtest summary/statistics (like the 
report) 

Risk free rates 

Defines risk free rates for Sharpe and UPl stats 
Distribution charts spacing 

Defines the spacing of profit, MAE and MFE distribution charts. The spacing is the % amount of 
profit/MAE/MFE per single bar in a chart. 


Generate detailed reports for individual backtests 
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This causes that in individuai backtest mode fuii report is generated and stored for every security under test. 
Note that this wiii siow down the test and take up quite a bit of hard disk space 

Include trade list In the report 

When turned ON (by defauit) the backtest report inciudes aiso trade iist. Note that trade iists may be huge and 
consume quite a bit of disk space 

Warn before time-consuming optimizations 

When turned ON (by defauit), AmiBroker wiii dispiay confirmation diaiog box when your optimization has more 
than 300 steps. 

Portfolio tab 



Max. Open Positions 

Max. Open Positions - the maximum number of simuitaneousiy open positions. .Settabie aiso using 
SetOption("MaxOpenPositions", number) function. 

Add artificial future bar 

When checked AmiBroker adds tommorrow's bar and this enabies you to see tommorrow's (or next bar) trade 
recommendations when your system uses one bar deiay. Artificiai future bar is has incremented date and 
voiume set to zero and aii price fieids (OHLC) set to CLOSE price of iast data bar. 

Limit trade size as % of entry bar volume 
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This prevents from entering the trades greater than given percentage of entry bar's voiume. For exampie if 
backtesting daiiy data and today's voiume for thiniy traded stock is 177,000 shares, setting this to 10% wiii 
iimit the maximum trade size to 17,700 shares (10% of totai daiiy voiume). This prevents from 'affecting the 
market' by huge orders. 

iMPORTANT NOTE: 

Some instruments iike MUTUAL FUNDS come without VOLUME data. To backtest such instruments piease 
set this fieid to ZERO (0) or check "Disabie trade size iimit weh bar voiume is zero" box. This effectiveiy turns 
OFF this feature. Otherwise you won't be abie to enter any trade at aii. 

Disable trade size limit when bar volume is zero 

When it is turned ON and the entry bar voiume is zero the backtesterwiii not appiy the "iimit trade size as % of 
entry bar voiume"- this is to aiiow backtesting mutuai funds that come with zero voiume data When it is OFF 
and entry bar voiume is zero then backtester wiii not aiiow to enter the trade on such bar. 

Use previous bar equity for position sizing 

Affects how percent of current equity position sizing is performed. 

Unchecked (defauit vaiue) means: use current (intraday) equity to perform position sizing, checked means: 
use previous bar ciosing equity to perform position sizing. 

Enable custom backtest procedure 

When checked AmiBroker appiies the custom backtest formuia specified in the fieid beiow to every backtest 
that you run. This is usefui if you want to permantentiy add your custom metrics to aii backtests without need 
to copy paste the same code. 

Custom backtest procedure path 

The fuii path to custom backtest formuia (see above). 

Old tab 

Drawdown figures based on... 

Drawdown figures in the backtest report measure equity dip experienced during the trade(s). To caicuiate the 
dip you can use the worst case scenario: iow price for iong trades and high price for short trades or singie 
price (open or ciose) for both iong and short trades. "Drawdown figures based on..." setting (pic. 2) aiiows you 
to choose the price(s) used to caicuiate drowndowns. Using worst case scenario you wiii get a few percent 
bigger drawdowns than using ciose or open price. On the other hand EquityO function aiways uses 
shortprice/coverprice array so you may choose open or ciose fieid here to match drawdowns as observed in 
equity iine. 

Formula 

- mark this box to inciude AFL formuia in the backtest report 
Settings 

- mark this box to inciude settings in the backtest report 
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Incl. out-of-market pos 

- mark this box to include out-of-market positions in the backtest report 
Overall summary 

- mark this box to include sum of individual symbol backtest results 
Symbol summary 

- mark this box to include per-symbol summaries 
Trade list 

- choose format of trade list included in the report 
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System test report window 

NEW BACKTESTER REPORT 

Exposure % - 'Market exposure of the trading system calculated on bar by bar basis. Sum of bar exposures 
divided by number of bars. Single bar exposure is the value of open positions divided by portfolio equity. 

Net Risk Adjusted Return % - Net profit % divided by Exposure % 

Annual Return % - Compounded Annual Return % (CAR) - this is 

Risk Adjusted Return % - Annual return % divided by Exposure % 

Avg. Profit/Loss - (Profit of winners + Loss of losers)/(number of trades) 

Avg. Profit/Loss % -'(% Profit of winners + % Loss of losers)/(number of trades) 

Avg. Bars Held - sum of bars in trades / number of trades 

Max. trade drawdown - The largest peak to valley decline experienced in any single trade 

Max. trade % drawdown - The largest peak to valley percentage decline experienced in any single trade 

Max. system drawdown - The largest peak to valley decline experienced in portfolio equity 

Max. system % drawdown - The largest peak to valley percentage decline experienced in portfolio equity 

Recovery Factor - Net profit divided by Max. system drawdown 

CAR/MaxDD - Compound Annual % Return divided by Max. system % drawdown 

RAR/MaxDD - Risk Adjusted Return divided by Max. system % drawdown 

Profit Factor - Profit of winners divided by loss of losers 

Payoff Ratio - Ratio average win / average loss 

Standard Error - Standard error measures chopiness of equity line. The lower the better. 

Risk-Reward Ratio - Measure of the relation between the risk inherent in a trading the system compared to 
its potential gain. Higher is better. Calculated as slope of equity line (expected annual return) divided by its 
standard error. 

Uicer index - Square root of sum of squared drawdowns divided by number of bars 

Uicer Performance index - (Annual profit - Tresury notes profit)/Ulcer lndex'>Ulcer Performance Index. 
Currently tresury notes profit is hardcoded at 5.4. In future version there will be user-setting for this. 

Sharpe Ratio of trades - Measure of risk adjusted return of investment. Above 1.0 is good, more than 2.0 is 
very good. More information http://www.stanford.edu/~wfsharpe/art/sr/sr.htm . Calculation: first average 
percentage return and standard deviation of returns is calculated. Then these two figures are annualized by 
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multipling them by ratio (NumberOfBarsPerYear)/(AvgNumberOfBarsPerTrade). Then the risk free rate of 
return is subtracted (currentiy hard-coded 5) from annuaiized average return and then divided by annuaiized 
standard deviation of returns. 

K-Ratio - Detects inconsistency in returns. Should be 1.0 or more. The higher K ratio is the more consistent 
return you may expect from the system. Linear regression slope of equity line multiplied by square root of sum 
of squared deviations of bar number divided by standard error of equity line multiplied by square root of 
number of bars. More information: Stocks & Commodities V14:3 (115-118): Measuring System Performance 
by Lars N. Kestner 

OLD BACKTESTER REPORT 



This window (accessible from Report button in Automatic analysis window) provides very useful information 
about the performance of a trading system under the test. The information included here can be customized 
using system test settings dialog. 

Explanation of values: 

Total net profit: This is total profit/loss realized by the test. Includes the closed-out value of the open position 
(if there is any). 

Return on account: This is total profit/loss as a percentage of initial investment. 

Total commissions paid: The amount of commissions paid during trades. 

Open position gain/loss: The closed-out value of open position that existed at the end of the test. 
Buy-and-hold profit: The total profit/loss realized by buy-and-hold strategy (including commission). 
Buy-and-hold % return: The total buy-and-hold strategy return as a percentage of initial investment. 

Bars in test: The number of bars tested (Overall summary shows sum of number of bars in all symbols). 
Days in test: The number of days between first bar date and last bar date (overall summary shows arithmetic 
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average of number of days accross the population of symbols under test) 

System to buy-and-hold index: An index showing how much better/worse is the system compared to 
buy-and-hold strategy. A value of 0% means that system gives the same profit as buy-and-hold strategy. A 
value of 200% means that system gives 200% more profit than buy-and-hold strategy. A value of -50% means 
that system gives a half of the gains of buy-and-hold strategy. 

Annual system % return: Calculated compound annual percentage return of the system (*see the note) 
Annual B&H % return: Calculated compound annual percentage return of the buy and hold strategy (*see 
the note) 

System drawdown: The largest equity dip experienced by the system (relative to the initial investment). 

B&H drawdown: The largest equity dip experienced by the buy and hold strategy (relative to the initial 
investment). 

Max. system drawdown: The largest point distance between equity peak value and the following trough 
value experienced by the system 

Max. system % drawdown: The largest percentage distance between equity peak value and the following 
trough value experienced by the system 

Max. B&H drawdown: The largest point distance between equity peak value and the following trough value 
experienced by the buy and hold strategy 

Max. B&H % drawdown: The largest percentage distance between equity peak value and the following 
trough value experienced by the buy and hold strategy 

Trade drawdown: The largest equity dip experienced by any single trade (relative to the trade's entry price). 
Max. trade drawdown: The largest point distance between equity peak value and the following trough value 
experienced by any single trade 

Max. trade % drawdown: The largest percentage distance between equity peak value and the following 
trough value experienced by any single trade 

Total number of trades: The number of trades (winners -i- losers) 

Percent profitable: The number of winning trades compared to total number of trades shown as a 
percentage 

Profit of Winners/Loss of losers: Total amount of money gained in winners/lost in losers. 

Total # of bars in winners/losers: The number of bars spent during winning/losing trades 

Largest winning/losing trade: The amount of biggest winner/loser 

# of bars in largest winner/loser: The number of bars in the biggest winning/losing trade 

Average winning/losing trade: The average of winning/losing trades (sum of winners/losers divided by a 

number of winning/losing trades) 

Average # of bars in winners/losers: The average of number of bars in winning/losing trades (total number 
of bars in winners/losers divided by a number of winning/losing trades) 

Max consec. winners/losers: The largest number of consecutive winning/losing trades. 

Bars out of the market: The number of bars for which the system was completely out of the market (was 
neither long nor short). If you open and close the position during single day, even if you have no open position 
on market open and no position on close this day is NOT considered as out of the market. 

Interest earned: The total interest earned between trades. Note that AmiBroker simulates 0/N (overnight) 
deposits. This means that if you closed the position on Monday and opened the next one on Tuesday you 
earn interest for single 0/N deposit. 

Exposure: Shows how much you are exposed to the market. It is a ratio of bars in the market divided by total 
number of bars under test. (The number of bars in the market is given by total number of bars minus bars out 
of the market) 
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Risk adjusted ann. return: Shows annual return of the system (*see note) adjusted (divided) by market 
exposure. If your system gained 10% over one year with the exposure of 50% the adjusted return would be 
20% (10%/0.5) 

Ratio avg win/avg ioss: The absolute value of the ratio of average winning trade to average losing trade 
Profit factor: The absolute value of the ratio of the profit of winners to loss of losers 
Avg. trade (win & ioss): The average trade profit calculated as sum of winners and losers divided by the 
number of trades. 

*Note: Calculation method used for annual percentage returns: 

Most of the software (including two the most popular so-called professional packages) use very simple 
annualization method based on the following formula: 

simple_annualized_percentage_return = percentage_return * ( 365 / days_in_test); 

unfortunatelly this method is wrong and very misleading since it would tell you that annual return is 22% when 
your system earned 44% during two years. This value is too optimistic. In fact annual return in this case is 
only 20%: if your initial investment was 10000 you earn 20% during the first year so you then get 12000 and 
20% the second year that gives you 14400 = (12000 * 120 % ). So after two years you earned 44% but 
annually it is only 20%. 

AmiBroker is one of the few programs that calculates annual returns correctly and will give you correct value 
of 20% as shown in the example above. The formula that AmiBroker uses for annual return calculation is as 
follows: 

correctly_annualized_perc_return = 100% * ((final_value/initial_value) ^ ( 365 / days_in_test) -1 ) 
where x^y means rising x to the power of y. 

Known differencies between statistics produced by 'oid' and 'new' fportfoiiol backtester 



Old backtester 

New (portfolio) backtester 

System and trade 
drawdown 
calculations based 

on 

Open/Close/H-L range (worst 
case) selectable in settings 

Close price only (regardless of settings) - subject to 
change 

Max. % trade 
drawdown 

Calculated based on total 
equity 

Calculated based on ACTUAL trade value at entry 
point. 

Stats available 

for all trades only 

separately for long, short and all trades 

PositionSizing 

Based on individual symbol 
equity 

Based on portfolio equity. 

PositionSize = -25; 

will enter 25% of current porfolio equity 

Trade statistics 

Include only closed trades, 
open trade is reported 
separately 

Include all trades (closed and those still open at the end 
of analysis period). Any open trades are closed out at 
'close' price always. 

Exposure 
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calculated regardless of 
position size (no matter on 
what is position size if trade is 
taken for particular bar it 
assumes 100% exposure at 
that bar) 

calculations include now (in 4.43.0) the total amount of 
open positions compared to total portfolio equity. 
Exposure is calculated on bar by bar basis so if only 

50% funds are in open trade, then exposure for this bar 
is 0.5. Then individual bar exposures are summed up 
and divided by number of bars to produce exposure 
figure. This way true market exposure is calculated. 

Multiple security 
testing 

N independent accounts 
(multiple single equity) 

Portfolio equity common to all symbols under test 
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Commission window 



Commission tabie is avaiiabie in the Account manager and in Automatic Analysis -> Settings window, 
"General" tab, "Commission and rates: Define..." 

In this window you can enter commission taken by buy/seii transactions. 

There are 5 tiers of commission scheduie tabie pius "defauit" tier that is used when others are not defined or 
transaction does not match any tier defined. Tiers can be defined based on transaction value or number of 
shares/contracts traded. Each tier has user definable minimum and maximum. If min/max is not defined or set 
to zero - the tier is not active. 

Each tier allows to define commission on per-share, per-trade, % of trade volume basis and allows to define 
minimum and maximum commission values based on dollar or percent values. 
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Commentary window 


A Guru Chart Commentary - Pricej^j^onei.afl 


Commentary 


Formula 


^ 1, Col 1 


Price and moving averages: 

MSFT(MICROSOFT CORP-COM) has dosed above its Short time 
moving average. 

Short time moving average is currently above mid-time, AND 
above long time moving averages. 

The relationship betvk'een price and moving averages is: bullish in 
short-term, and bullish in mid-long term. 

Bollinger Bands: 

MSFT(MICROSOFT CORP-COM) has dosed below upper band by 
27.9%. 

Bollinger Bands are 58.0% narrower than normal. 

The narrow width of the bands suggests low volatility as 
compared to MSFT(MICROSOFT CORP-COM)'s normal range. 
Therefore, the probability of volatility inaeasing with a sharp 
price move has increased for the near-term. The bands have 
been in this narrow range for 3 bars. The probability of a 
significant price move inaeases the longer the bands remain in 
this narrow range. 

This commentary is not a recommendation to buy or sell. Use at 
your own risk. 


Apply 


Load 


Save 


Close 


Commentary window enables you to view textual descriptions of actual technical situation on given market. 

Commentaries are generated using formulas written in AmiBroker's own formula language. You can find the 
description of this language in AmiBroker Formula Language Reference Guide. 

Moreover Commentary feature gives you also graphical representation of buy & sell signals by placing the 
marks (arrows) on the price chart. 


Newbies should read "Tutorial: Flow to write your own commentary" for step-by-step instructions and working 
with AFL editor. 


"Refresh" button causes AmiBroker to reinterpret the commentary using currently selected symbol/date. 
"Load" and "Save" buttons allow to load/save commentary formulas. 

"Close" button closes the commentary window. 

Now the Guru chart commentary window is automatically updated and sychronized with the date selected on 
the chart using "Pick" selector tool. This way you can easily read any indicator value on any selected date 
right off the chart commentary window. 
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Plugins window 

Plugins window lists all loaded plug in DLLs. It is useful for inspecting which plugins are active. 



In addition to just showing the list of plugins you can unload all DLLs by pressing "Unload" button and load 
them back by pressing "Load" button. Please note that a DLL must be placed in the "Plugins" subfolder of 
AmiBroker main directory to be seen. 

At start AmiBroker scans the "Plugins" folder and loads the DLLs that follows the specifications of AmiBroker 
plugin. If a DLL is loaded it is "locked" for writing so it can not be overwritten or modified. 

During the development process it is necessary to overwrite/modify the DLL code - because when you apply 
the changes to the source code these changes must be recompiled and stored into DLL file. To allow the 
developer to oven/vrite the DLL used by AmiBroker the "Unload" function is available in this window. 
Unloading releases the DLL so it can be overwritten without the need to restart AmiBroker. Then, after 
modifying the DLL code, you can load the DLL back using "Load" function. 

IMPORTANT NOTE: AmiBroker makes no representations on features and performance of non-certified 
third-party plug-ins. Specifically certain plug-ins can cause instabilities or even crashes. Entire use of 
non-certified third-party plugins is at your own risk. 
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Indicator Maintenance Wizard 

Indicator maintenance checks for any indicators that were deieted from any iayouts on your hard disk and 
frees tabie from entries 

aliocated for indicators that were deleted. This procedure is rarely but still needed because if you delete 
indicator from one 

layout there is no guarantee that there is no other layout file buried somewhere on your hard disk that still 
references given indicator. 

So Indicator Maintenance scans all hard disks and all partitions looking for layout files and analysing them to 
built the 

" actually used" table of indicators. 



The ones which are not referenced by any layout can be deleted from internal table. 

Depending on your choice you may leave default behaviour (cleaning up only internal table) or deleting actual 
formula files 

that are not referenced. This is up to you. If you don't use particular formula for say AA 
Scan/Backtest/Optimization you can 

delete it. If you use it or need it for some archive purposes - leave it unchecked. 
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The list below shows indicator formulas that are not currently referenced by any layout 
found on your hand disk. Unused files in 'drag-drop' folder were automatically marked for 
deletion, you may mark files in other folders if you wish to delete them too. 


The wizard has found 124 unused indicator memory entries and 24 formula files 
0 Show formulas in Custom and Drag-drop folders only 


Formula name 

Qi 

0 Formulas\Drag-drop\Portfollo l .afi 

0 Formulas\Drag-drop\Price (all in one) 1 .afl 

0 Formulas\Drag-drop\Price (all in one) 2.afl 

0 Formulas'\Drag-drop\Prtce (all in one) 3.afl 

0 Formulas\Drag-drop\Price (all in one) 4.afl 

0 Formulas\Drag-drop\Prtce (all in one) S.afI 

0 Formulas\Drag-drop\Price (all in one) 7.afl 

1 

0 Formulas\Drag-drop\Price 1 afl 

0 Formulas\Drag-drop\Price 2.afl 

II 

Si 

0 Formulas\Draa-droo\Price 4.afl 


Bi 


Zakoticz 


Anuluj 


Pomoc 


If you are not sure what options to choose, just press "Next" all the time and you will safely complete the 
procedure without changing any settings. 
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Log window 

The Log window (available from Window->Log menu) allows to view: 

• edit-time errors displayed during formula check 

• run-time errors that occur when formula is running (not edited) 

• _trace command output within AmiBroker (without using 3rd party debug view) 

To perform tasks such clearing the output, copying, changing settings use right - mouse click over the log 
window list. 

Double click on the error line brings up the editor, so you can fix the error easily. 

While "edit-time" error list is cleared automatically each time you check the syntax in the editor, the run-time 
error list is NOT cleared, so all errors remain listed, even if they are fixed already, unless you manually clear 
the list. 

Note that_TRACE output is by default directed to outside debugger (like DebugView), in order to enable 
internal display you need to switch appropriate option in the Tools->Preferences->AFL You can choose to 
display internally / externally or in both places. 

Internal _trace has much lower performance penalty (order of magnitude) than external, but that is achieved 
by the fact that 

internal log window is refreshed only when application is not busy. It is appropriate for some uses, but you 
may prefer more immediate 
refresh offered by DebugView. 

Note that internal log window accepts special string "ICLEAR!" that causes deleting contents of the log 
window, as presented in the example below: 

_TRACE("!CLEAR!"); // this clears the internal log window. 

_TRACE("First line after clear"); 


Log window 


399 



AmiBroker 6.00 User's Guide 


AmiBroker Reference Guide 


Performance Monitor window 




A Performance Monitor 


4 - 


Item 

Value 

Symbols in the database 

143 

Symbols in the cache 

2 

Quotation data cache size 

40.1MB 

Current symbol data 

350080 bars (13.4MB) 

Virtual memory available 

3888.3 MB 

Page file available 

4096.0 MB 

Total chart refresh time 

0.002 s 

Real-time data stream 

1.6 updates per sec 




The performance monitor is avaiiabie from Tools->Performance Monitor menu and it shows some memory 
and usage statistics: 

• number of symbols in the database 

• number of symbols cached in RAM 

• quotation data memory usage 

• current symbol memory usage 

• total chart refresh time 

• real-time data stream update frequency 

The contents of the window is updated automatically every 3 seconds 
This tool is intended to be used now for two purposes: 

a) tweaking cache settings for best RAM usage (for example optimizations will run faster if all quotation data 
can be kept in RAM) 

b) monitoring real-time performance 

More uses will probably come in the future. 


Log window 


400 













AmiBroker 6.00 User's Guide 


AmiBroker Reference Guide 


Menus 

This chapter describes AmiBroker menus. 


A AmiBroker - (HD - HOME DEPOT INC - Daily] 

^ File Edit View Insert Format Symbol Analysis 

□ -o O aa 

Tools Window j 

_ HD 

IT 

Help 


Q) -f 
'< 

° <Search> 

" All 


I Delete L 

■Emr- 


.3756, Lo 22.3663, Close 22.69 (0.4%) Vol 185,5; 

I. 


There are foiiowing main puii down menus: 


• Fiie 

• Edit 

• View 

• insert 

• Format 

• Symboi 

• Anaiysis 

• Toois 

• Window 

• Fieip 

And the foiiowing CONTEXT menus: 

• AFL Editor context menu (avaiiabie when you ciick with RiGFiT mouse button in the AFL editor) 

• Automatic Anaiysis window context menu (avaiiabie when you ciick with RiGHT mouse button over 
Automatic Anaiysis RESULT LiST) 

• Aiert Output context menu (avaiiabie when you ciick with RiGHT mouse button in the Aiert Output 
window) 

• Chart pane context menu (avaiiabie when you ciick with RiGHT mouse button in the chart pane) 

• Layouts context menu (avaiiabie when you ciick with RiGHT mouse button in the Workspace -> 
Layouts tree) 

• Formuia context menu (avaiiabie when you ciick with RiGHT mouse button in the Workspace -> 
Charts tree) 

• Layers context menu (avaiiabie when you ciick with RiGHT mouse button in the Workspace -> Layers 
iist) 

• ReaiTime Ouote context menu (avaiiabie when you ciick with RiGHT mouse button in the Reai time 
quote iist) 
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File menu 



• Database 

Creates a new AmiBroker database and launches Database settings window. 

• Default Chart 

Creates new chart window using default template. It's possible to select the symbols and time frame 
independently in each of the windows opened. 

• Linked Chart 

Creates linked chart window based on current template and active chart. Linked windows use the 
same symbol selection, so if you change the selected symbol for one of them, the other one will 
synchronize automatically. Linked windows can have DIFFERENT viewing time frame selected. 
Simply activate the window and select desired interval from View menu for one window, then switch to 
the other one and select different interval for it. This option allows you to select different time frame or 
indicators' set in each window and easily move through the database. 

• Blank Chart 

Creates new (blank) chart window. This is useful if you want to create completely new setup of charts 
that do not share the same chart IDs. It is important if you want to have indicators that have 
independent parameters from the other windows that you have created. 

• Blank Pane 

Creates new (blank) chart pane 

• Account 

Creates New Account (Account Manager) 

• Web Research 

Creates New Web Research window 
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Open 

Opens document (account, database or HTML file - you can pick document type from "Files of type" combo in 
the File selector window) 

Close 

Closes current (active) document window (chart, account, web research) 

Open Database 

Allows you to open an existing AmiBroker database. Please select the database folder and press OK. 

Save Database 

Saves the currently used database 

Save Database As... 

Saves database into new location 

Save 

Saves current document (account, html file) 

Save As... 

Saves current document (account, html file) under new name 

Save All 

Saves all documents currently open 

Database Settings 

Opens Database settings dialog that allows you to change your database parameters or intraday settings. 

Import Wizard 

Launches ASCII Import Wizard window, that allows you to easily import ASCII (text) files into your database 

Import ASCII 

Allows you to import ASCII files with use of predefined import formats. To learn more how to use ASCII 
importer, please read ASCII Importer reference chapter. 

Import MetaStock data 

Launches Metastock importer window. IMPORTANT NOTE: Metastock importer should be used ONLY if you 
want to import MS data to native, local AmiBroker database once. If you want AmiBroker to just read 
Metastock database DIRECTL Y without need to import new data over and over please set up your database 
WITH METASTOCK PLUGIN as described in the Tutorial. 

Print 

Allows you to print currently displayed charts. 


Print Preview 

Prints currently displayed charts with the preview (you can check the appearance of the document before it's 
printed). 

Print Setup 

Opens printout setup dialog. 
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Send Chart via E-mail 

AmiBroker creates .png image (with the currentiy dispiayed chart) and uses your defauit maiiing program (e.g. 
Outiook Express) to send the fiie as an attachement. 

Exit 

Cioses AmiBroker program. 
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Edit menu 


iker - ;MCD - MCDONALDS CP - Da'Iy] 


Edit 

View 

Insert Format 

Symbol Analysis Tools 


tn 

Jndo 

Ctrl+Z 

5 o c o a mcd 


Cut 

Ctrl+X 

X 

/MCD (Daily) 

> 

% Copy 

Ctrl+C 

El’ 

- Price = 63.670 







X 

Delete 

Del 





Delete Al 

Alt* Del 




I Image 

► 

^ Copy As Bitmap 





Delete guotation 
Delete session 
Properties Alt+Enter 


Copy As Metafile 

Export to file 
^ Send by E-mail 


Undo 

Allows to undo the last operation performed on chart studies (trendlines etc.)- This option will be unavailable If 
no study has been drawn or moved. 

Cut, Copy, Paste, Delete 

These options can be used to cut, copy, paste or delete studies from the chart. Cut, copy and delete will be 
greyed out If no object on the chart Is selected. To paste the object. It's necessary to use 'copy' or 'cut' option 
first. 

To learn more about drawing tools In AmiBroker, please read Drawing tools reference chapter. 

Delete All 

Deletes all the objects from the currently opened chart window. 

Image 

• Copy As Bitmap - copies the curently opened chart to the system clipboard as a .BMP Image. You 
can paste the clipboard contents e.g. Into 'Paint' application. 

• Copy As Metafile - copies the curently opened chart to the system clipboard as a metafile 

• Export to file - saves the currently displayed chart as .PNG file 

• Send by E-mall - AmiBroker creates .png Image (with the currently displayed chart) and uses your 
default mailing program (e.g. Outlook Express) to send the file as an attachement. 

Delete quotation 

Deletes currently selected bar. 

Delete Session 

Deletes currently selected bar from ALL the symbols In the database. 

Properties 

Opens a study properties dialog. More Information can be found In Drawing tools reference chapter. 
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View menu 


- [''DJI - DOW .ONES INDUS'R - Houriy] 

View Insert Format Symbol Analysis Tools Windo 

-p Crosshair Ctrl+H 

X-Y labels ► 

OS-: *DJI 

X 

^ ''DJI (Hourly 
^DJI- Hourly 2011-0 

Price chart style ► 


Intraday ► 

Day/Night 

d Daily Ctrl+D 

w Weekly Ctrl+W 

m Monthly Ctrl+M 

Quarterly 

Yearly 

b Hourly Ctrl+0 

(j|) 15-minute Ctrl+6 
@ 5-minute Ctrl+5 
(T) 1-minute Ctrl+1 

Filtering ► 


Zoom ► 


History ► 

3-minute 

Pane ► 

7-minute 

Toolbars ► 

10-minute 

Refresh F5 

Refresh All 

12-minute 

20-minute 


-n—f- mv i 

pcmnrercsTXTTirorKT 

ice 

ice (all in one) 
ice (foreign) 
dative Performance 

iread 


Crosshair 

Turns on/off crosshair. 

X-Y labels 

Controls the display of X-Y value labels 

• Off 

• With crosshair only - display X-Y value labels 
when crosshair is activated 

• Always on - always display X-Y value labels 

Price Chart Style 

Changes the style of the default Price chart 

• Auto - uses settings defined in Tools 
->Preferences 

• Line - line chart 

• Candlesticks - candlestick chart 

• Bars - traditional bar chart 

Intraday 

Allows you to chose one of intraday time intervals and 
decide whether to display day or night sessions. Day and 
night sessions' hours can be set in: Database settings 
window (File -> Database Settings -> Intraday settings) or 
separately for group in Categories window (Symbol -> 
Categories). 

• Day / Night - shows two bars (day and night) per 
day 

• Show 24 hours trading - no filtering is applied 
and all the data in the database is included in the 
chart. 

• Show day session only - displays day sessions 
only. 

• Show night session only - displays night 
sessions only. 

• Show day and night sessions - displays day 
and night sessions. 


Daily, Weekly, MonhIy, Quarterly, Yearly 

Allows to change the display time interval. 


Pad non-trading days 

Enable padding of Saturdays, Sundays and other 
non-trading days with previous close price 
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Filtering 

Allows to choose between no filtering (24 hours trading 
display), regular trading only, extended trading only. 


Zoom ► 

In Ctrl+Num + 

History ► 

Out Ctrl+NuiW- 

Pane ► 

All 

Toolbars ► 

Normal 

g] Refresh F5 

Range 

Refresh All 

X Shorter bars 


^ Taller bars 


Zoom 

Controls the zoom of the chart 

• In - reduces number of bars displayed 

• Out - Increases number of bars displayed 

• All - displays all the available bars for the current 
symbol 

• Normal - displays default number of bars (defined 
In Tools -> Preferences -> Charting) 

• Range - displays the bars from the selected 
range 

• Shorter bars - reduces the vertical size of the 
bars 

• Longer bars - Increases the vertical size of the 
bars 


History 

Allows to move Back/Forward In 'browser-llke' way. 

• Previous move to previous symbol (keyboard 
shortcut: Ctrl+Alt+LEFT) 

• Next move to next symbol (keyboard shortcut: 
Ctrl+Alt+RIGHT) 


Pane ► 

X 

Toolbars t 

m Arrange all K | 

g] Refresh F5 

Refresh All 

Maximize 

pen inicrRl ^lUlUfCS^ 

ice 

ice fall in one^ 


Pane 

• Close - closes curently selected chart pane 

• Arrange All - arranges all the displayed charts 

• Move Down - moves curently selected chart 
pane one position down 

• Move Up - moves curently selected chart pane 
one position up 

• Maximize - maximizes curently selected chart 
pane 

• Restore - restores the charts layout after using 
Maximize 


Toolbars 

Allows you to dIsplay/hIde the toolbars. 
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Refresh 

Refreshes the chart window. 

Refresh All 

Refreshes the chart window and re-reads the contents of ali the categories in symbols tree in Workspace 
window. 


Note to users of previous versions: the items that control Symbol, Layouts, Layers, Charts, Information and 
other windows have been moved to Window menu. 
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Insert menu 


FX - Polish Zloty - Daily] 


Insert *ypFgrmat Symbol 



Trend line 

/ 

Ray 


Extended line 


Horizontal line 

I 

Vertical line 

// 

Parallel lines 

# 

Regression Channel 


Andrews' Pitchfork 

A, 

Triangle 

□ 

Rectangle 

O 

Ellipse 


Arc 

III 

Cycle 

abc 

Text 

V 

Zig-zag 

J* 

Arrow 


Fibonacci 


Gann 

BUY 

T 

Buy Order 

$EIL 

Sell Order 


Trend line 

Draws a trend line. 

To draw a trend line the chart - start drawing by pointing the mouse and pressing left mouse button where you 
want to start the drawing. Then move the mouse and study tracking line will appear. Release left mouse 
button when you want to finish drawing. Alternatively you can click once in the place where you want the 
trendline to begin, move the mouse and click once again to finish drawing. You can also cancel study drawing 
by pressing ESC (escape) key. 


Ray 

Draws a ray. Ray is a right-extended trend line. 


Extended line 

Draws an extended line. Extended line is a trend line that is extended automatically from both left- and right- 
sides. 


Horizontal line 

Draws a horizontal line. Horizontal line is self expanding so it is only necessary to click on the chosen 
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price-level. 


Vertical line 

Draws a vertical line. Vertical line is self expanding so it is only necessary to click on the chosen bar. 


Parallel lines 

Draws parallel trendlines. 

This tool allows to draw a series of parallel trend line segments. First you draw a trend line as usual, then a 
second line parallel to the first is automatically created and you can move them around with the mouse. Once 
you click on the chart it is placed in given position. Then another parallel line appears that can be placed 
somewhere else. And again, and again. To stop this please either press ESC key or choose "Select" tool. 


Regression channel 

Draws Raff, standard deviation, standard error channels. To read the detailed information regarding this tool 
please read Drawing tools reference chapter. 


Andrews' pitchfork 

Draws an Andrews' pitchfork. Read Drawing tools reference chapter for more detailed information. 


Triangle 

Draws a Triangle. Left-click in the first point, move to the second point then click once, then move to the third 
point and click once again. 


Rectangle 

Draws a rectangle. Left-click in the first point, move to the position where you want to place the oposioposite 
corner and click once again. 


Ellipse 

Draws an Ellipse. Ellipse is connected to the date/price coordinates (as trend lines) rather than to the screen 
pixels so it can change the visual shape when displayed at various zoom factors or screen sizes. To see the 
properties of ellipse you should double-click on the clock-like 3, 6, 9 or 12 hour positions. 
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Arc 

Draws an Arc. Arc, the same as Ellipse is connected to the date/price coordinates (as trend lines) rather than 
to the screen pixels so it can change the visual shape when displayed at various zoom factors or screen 
sizes. To see the properties of ellipse you should double-click on the clock-like 3, 6, 9 or 12 hour positions. 


Cycle 

Draws time cycles. To use time cycles tool, click on the cycles drawing tool button in the toolbar then click at 
the starting point of the cycle and drag to the end of the cycle. These two control points control the interval 
between the cycle lines. When you release the mouse button you will get a series of parallel lines with equal 
interval in between them. 


Text 

Allows to place a custom text on the chart. Left-click on the chart to start typing. To finish - click once again on 
the chart, outside the text box. You can also cancel typing by pressing ESC (escape) key. 


Zig-zag 

Draws a series of connected trend lines. To finish the series double-click or press ESC (escape) key. 


Arrow 

Draws a line that ends with an arrow. Drawing technique is exactly the same as drawing a trend line. 


Fibonacci 

► 


Retracement 

Gann 

► 

lime zones 

^ Buy Order 



Fan ) 

Sell Order 



Arc 

-K™ r 

|r,' T 

Hi 

Extension 

Time Extension Lines 


• Fibonacci Retracement study 

• Fibonacci Time zones study 

• Fibonacci Fan 

• Fibonacci Arc 

• Fibonacci Extensions 

• Fibonacci Time Extension lines 


Fibonacci 

Group of Fibonacci drawing tools. Read Drawing 
tools reference chapter for more detailed 
information. 
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Gann 

Group of Gann drawing tools. 

• Gann Fan 

• Gann Square 

Read Drawing tools reference chapter for more detailed information. 
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Format menu 


Format Symbol Analysis lools Window F 
_ PLN AO-FX (Po - 



These options allow you to apply color or style to the objects. Note that you can also select color and style of 
the object before drawing new object: simply deselect previous object (if any), change style selections and 
draw new object. 

Thick 

Changes drawn object formatting to thick style. 

Dotted 

Changes study formatting to dotted style. 

Left Extend 

Extends the trendline to the left. 

Right Extend 

Extends the trendline to the right. 

Snap to price 

Turns on the magnet that snaps the drawn studies to the prices. Snap to price % threshold can be set in 
Preferences window. Snap to price % threshold defines how far price 'magnet' works, it will snap to price 
when the mouse is nearer than % threshold from H/L/C price 
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Symbol menu 


Symbol Analysis Tools Window Help 


[Po 


% 

New... 



Delete 


5: 

Split... 



Merge... 



Find 

F3 

0 

Information... 


m 

Quote Editor... 



Favourites 

► 




14 23:59:00 Open 2.959. Hi 2.959, Lo 5 


A 



Watch list 


Real Time Quote 
Categories... 

Organize assignments... 
Calculate composites... 


? X 


Sep 


'Nov 


PLN A0-FX-TSF(Close.15 



Add selected symbol... 
Remove selected symbol, 
lype-in symbols,,. 
Import... 

Export... 

Erase (make empty)... 

Sort alphabetically... 

Hide empty watchlists 
New watchlist... 

Delete watchlist... 


New 

Allows you to add new symbols Into the database. After selecting this function you will be prompted for new 
ticker symbol. Please try not to exceed 26 chars. For proper Import functioning you should enter the symbol 
with CAPITALS. 

Delete 

Removes currently selected symbol from the database. After choosing this function you will be asked for 
confirmation of symbol removing. Note well that this operation can not be undone. 

Split 

Allows you to perform stock split. AmiBroker provides easy way of handling stock splits. Program will try to 
guess split date and ratio by analyzing quotations. If there Is just a single quotation after split this should work, 
If not you will be asked for split date and ratio. You can specify a split using following expression: x->y which 
means that x shares before split become y after It. For example 2->3 means that 2 shares become 3 after the 
split. It Is also possible to perform reverse-split, for example 2->1, which means that 2 shares are joined 
together Into 1 share. 

Merge 

This function allows you to merge two tickers, when the ticker for the symbol Is changed and In your database 
- one symbol holds historical quotes and the second one holds newest quotes (after name change). I You 
should just select the new ticker (after name change) and use Symbol->Merge. Then from the combo you 
should choose original ticker ("merge with") and optionally check the following fields: 

• overwrite duplicate quotes - checking this option will overwrite the quotes already existing In "new" 
ticker with those present In "old" ticker (this should really not be the case, but may happen). 

• delete "merge with" afterwards - checking this option will delete the "old" ticker after merging 
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• assign alias name - checking this option will copy the "old" ticker to the alias field of the "new" ticker 


Find 

Opens Symbol finder window that allows you to quickly search the database for a symbol by typing the first 
letters of its full name or ticker. 

Information 

Opens the Information window for the symbol, which allows you to change the symbol properties. 

Finances 

Finances window allows you to enter some fundamental data for the symbol (sales income, earnings before 
taxes (EBT), earnings after taxes (EAT)). AmiBroker will compute P/E (Price to Earnings ratio) and EPS 
(Earnings Per Share) indicators out of the data given. 

Quote Editor 

Opens Quote Editor window that allows you to edit, delete and add quotations into your database. 

Watchlist 

These options allow you to manage your watchlists. Working with watch lists chapter explains in more detail 
the way you can use the below options. 

• Add Selected Symbol - adds the currently selected symbol to the specified watchlist(s). 

• Remove Selected Symbol - removes the currently selected symbol from the specified watchlist(s). 

• Type-in Symbols - allows you to type-in the symbols to the watchlist(s). 

• Import - allows to import the watchlist from the .TLS file 

• Export - exports the symbols belonging to the watchlist to the .TLS (symbol list) file 

• Erase (make empty) - removes all the symbols from the specified watchlist. 

• Sort alphabetically - sorts tickers alphabetically in the specified watchlist 

• Hide empty watchlists - hides watch lists with no symbols in the symbol tree 

• New watchlist - creates new watch list 

• Delete watchlist - deletes selected watch list (it does not delete symbols from teh database) 

Categories 

Categories window allows you to define names of markets, groups, sectors and industries. For each market 
you can also define base indexes for calculating relative strength, composite data, beta or web profile URL. 

Organize assignments 

Assignment organizer window allows you to easily change the category assignments for the symbols or to 
delete multiple symbols from the database. 

Calculate Composities 

Opens Composite calculation window that allows for automatic calculation of number and volume of 
advancing/declining/unchanged issues or volume numbers for indices. 
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Analysis menu 


Analysis f lools Window H 


Qj^k Review... 

1 

• 

Automatic Analysis... 


Commentary... 


Formula Editor... 


AFL Code Wizard 


Quick Review 

Opens Quick review window that provides overali market information like: daily symbol quotes, 
daily/weekly/monthly/quarterly/yearly returns comparison table or Price/Earnings and Price/Book value 
comparison. 

Automatic Anaiysis 

Opens Automatic Analysis window that enables you to check your quotations against defined buy/sell rules or 
explore your database. AmiBroker can produce report telling you if buy/sell signals occurred on given symbol 
in the specified period of time, simulate trading, giving you an idea about performance of your system or 
optimize the trading system you use to improve it's performance. 

Commentary 

Displays Commentary window which allows you to view textual descriptions of actual technical situation on 
given market. 

Formula Editor 

Opens the Formula Editor window that enables you to write your own formulas. 

AFL Code Wizard 

Opens the AFL Code Wizard - the add-on program that creates trading system AFL code from plain English 
sentences. See introduction video to AFL Code Wizard. 
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Tools menu 


Tools Window Help 


1^ Database Purify... 


Indicator Maintenance... 
1^ Bar Replay... 

Performance Monitor... 
Preferences... 

Save preferences 




Plug-ins... 

Customize... 

Auto-update quotes (AmiQuote only) 
Sharenet Downloader 
Cleanup database 


Database Purify 

Database purify tool allows to detect missing/extra quotes, possible splits or invalid OHLC relationship. 

Indicator Maintenance 

Opens Indicator Maintenance wizard, that helps to clean up unused indicator space 

Bar Replay 

Opens Bar Replay tool, which allows to replay historical data. 

Preferences 

Opens Preferences window which allows you to configure the program. 

Save Preferences 

Saves all the preferences changes (the information is store in broker.prefsiWe). 

Plugins 

Opens Plugins window. It contains the lists of all loaded plug-in DLLs and can be used for inspecting which 
plugins are active. It's also possible to unload the plugins. 

Customize 

Customize tools dialog allows you to define custom tools that can be invoked from Tools menu. 

Auto-update quotes 

Auto-update quotes option updates historical quotes from the last date present in AmiBroker upto today with 
use of AmiQuote Downloader. The detailed description on how to use AmiQuote do obtain free quotations can 
be found in Automatic update of EQD quotes tutorial chapter. 

Sharenet Downloader 

Launches the script which downloads the quotations from Sharenet (South Africa only). 

Export to CSV file 

Runs a script that exports the database to the CSV file. Note that you can use Automatic Analysis window to 
export the quotes way faster than with use of this script. 
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Cleanup database 

Launches the script that allows you to find non-traded stocks in the database. Script automatically scans the 
database and checks the latest quotation date. If it is old enough, the script will display warning message and 
lets you decide whether the stock should be deleted or not. Additionally script can generate a list of "old" 
stocks and save it to the text file. The detailed information is available in: 05-2000 issue of the newsletter. 
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Window menu 


Window Help 
I ^ I Normal 
Floating 
■y Symbols 
I I Layouts 
I I Layers 
I I Charts 
^ Interpretation 
I ■y I Realtime Quote 
Alert Output 
Notepad 

Symbol Information 
Time & Sales 
Log 

Data Window 
Risk/yield map 


^ Cascade 
H Tile Horizontally 
m Tile Vertically 
Arrange Icons 

I •y I 1AAASX - DWS Alternative Asset Allocation Fund - Daily 


IMPORTANT NOTE to old version users: Window -> New and Window -> New Linked options have been 
moved to File->New->Default Chart and File->New->Linked Chart menus. 


Symbols tab - symbols tree with categories (See: Understanding categories). 

Layouts tab - list of available global and local layouts (See: Working with chart sheets and window layouts). 
Layers tab - list of chart layers (See: Working with layers). 

Charts tab - the window showing the list of chart formulas (See: Working with drag-drop charting interface). 

Interpretation 

Displays/hides the Interpretation window. 

Realtime Quote 

Displays/hides the Realtime Quote window. The RT quote window provides real-time streaming quotes and 
some basic fundamental data. To learn more read: How to use AmiBroker in Real Time mode chapter. 

Alert Output 

Shows/hides Alert Output window. The window displays texts generated by formula based alert. The detailed 
information on how to use alerts is available in: Using formula-based alerts part of the Users' Guide. 
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Notepad 

Displays/hides Notepad window, that allows to store tree-text notes about particular security. Just type any 
text and it will be automatically saved / read back as you browse through symbols. Notes are global and are 
saved in "Notes" subfolder as ordinary text files. 

Symbol Information 

Shows symbol information window with fundamental data. 

Time & Sales 

Shows Time and Sales real time window 

Log 

Shows the log window that displays AFL error messages, run-time errors and _TRACE output 

Data window 

Shows the data window that displays values of chart indicators 

Risk/Yeld map 

Displays RiskA'eld map of all the symbols in the database. Risk/yield map calculates average weekly return 
(the yield) and standard deviation of the weekly returns (the risk) over at least 12 weeks. It requires at least 60 
bars worth of data for every stock. To zoom in - mark the area with the mouse. To zoom-out simply click on 
the map. 

Cascade 

Cascades opened chart windows. 

Tile Horizontaly 

Tiles the opened chart windows horizontally. 

Tile Vertically 

Tiles the opened chart windows vartically. 

Normal 

Switches the chart window to "normal" (non-floating) state. More info here. 

Floating 

Switches the chart window to floating state. More info here. 

Arange Icons 

Allows you to arrange the minimized windows. Arrange icons works only if: 

• You created more than two windows (via Window->New or Window->New Linked) 

• You have minimized them 

• You moved the minimized boxes 

Arrange icons option will align the windows nicely at the bottom of the AmiBroker window. 
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Help menu 


Help 


^ Help Contents 
^ Search 

^ _ T i 


Tig of the Day... 

,Lo 2.8678. Close 2.8883 (-I.I- 

Web links ► 

AmiBroker Home Page k 

Why register? 

Register On-line 

Mailing list 

On-line AFL library 

AFL Function Reference 

Read Me 

About AmiBroker... 

-I 



Help Contents 

Displays the contents of the AmiBroker Users' Guide. 

Search 

Allows you to search the Users' Guide. 

Tip of the day 

Shows Tip of the c/ay dialog where many useful usage tips are displayed. 

AmiBroker on the web 

• link to AmiBroker Home page 

• list of benefits for registered users 

• secure On-line order form 

• AmiBroker Mailing List 

• On-line formula library 

• On-line AFL function reference 

Readme 

Displays the contents of Readme file. Please note that all the recent changes in beta releases are reported in 
Readme. 

About AmiBroker 

Shows the 'About' window, which contains the information about program version and user details. 
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AFL Editor menu 



AFL editor features separate menu consisting of the foiiowing choices: 
1. File 


A [Formulas\Custom\Ui 



where 


• New - clears the formula editor window 

• Open - opens the formula file 

• Save - saves the formula under current name 

• Save As.. - saves the formula under new name 

• Print - prints the formula 

• Exit - closes the editor 
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2. Edit 


E(|M| lools Help 


® Paste 
Select All 
Find- 
Replace 

Prettify Selection 


where 

• Undo - un-does recent action (muitipie-ievei) 

• Redo - re-does recent action (muitipie-ievei) 

• Cut - cuts the seiection and copies to the ciipboard 

• Copy - copies the seiection to the ciipboard 

• Paste - pastes current ciipboard content in the current cursor position 

• Seiect Aii - seiects entire text in the editor 

• Find... - provides access to text search tooi 

• Copy Error Message - copies current error message dispiayed in the bottom of the editor window to 
the ciipboard (option is active only when there are any errors displayed after syntax check) 


3. Tools 


Xoo^l ^ Help 



Verify syntax 



Agply indicator 



Insert chart 


1 

• 

Send to Auto-Analysis 



Scan 

Exploration 

Backtest 

Optimization 

Code £heck & Profile 

Options ► 


where 


• Verify syntax - checks current formula for errors 

• Apply indicator - saves the formula and applies current formula as a chart/indicator ONCE 

• Insert chart - saves the formula and applies current formula as a chart MANY TIMES (inserts multiple 
times) 

• Send to Auto-Analysis - saves the formula and selects it as current formula in Automatic Analysis 
window 
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• Scan - saves the formula and performs Scan in Automatic Analysis window 

• Exploration - saves the formula and performs Exploration in Automatic Analysis window 

• Backtest - saves the formula and performs Backtest in Automatic Analysis window 

• Optimization - saves the formula and performs Optimization in Automatic Analysis window 

• Check - saves the formula and performs Check (if given formula references future) in Automatic 
Analysis window 

• Options: Auto-save formula before running analysis - when checked, any click on 
Scan/Explore/Backtest/Optimize button in Automatic Analysis window triggers automatic save of 
current formula. 


4. Help 




unction reference 


Parameter info 
AFL Language Reference 
Function index by Name 
Function index by Category 
Help on Editor 


where 

• Function reference - displays reference page for currently highligted AFL function, more on this 
feature here. 

• Parameter info - displays parameter tooltip for currently highlighted AFL function, more on this feature 
here. 

• AFL Language reference - displays language reference page. 

• Function index by Name - displays alphabetical list of AFL functions. 

• Function index by Category - displays categorized list of AFL functions. 

• Help on Editor - displays this help page. 

as well as context menu (available via RIGHT click over the formula): 


Cut J 

Ctrl+X 

Copy 

CtrkC 

Paste 

CtrkV 

Delete 

Del 

Undo 

Ctrl+Z 

Redo 

CtrkY 

Select All 

Ctrl+A 

Find 

Ctrl+F 

Print 

Parameter info 


Function reference 

FI 


which essentially duplicates choices available from regular menu. 
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Automatic Analysis result list context menu 



This menu shows up when you click with RIGHT mouse button over Automatic Analysis result list. 


Available choices: 


• Show arrows for all raw signals - show buy/sell/short/cover arrows for all raw (unfiltered) signals. If 
your formula is for example 

buy = C > MA( C, 10 ); 

you will get a buy (solid green) arrow for all bars where close was above 10-bar moving average 

• Show arrows for actual trades - show arrows only on trade entry/exit bars. This shows arrows for ALL 
TRADES. If your formula is for example 

buy = C > MA( C, 10 ); 

you will get a buy (solid green) arrow only for the very first bar when close crossed above moving 
average and trade was initiated, and you won't get any subsequent buy arrows until a matching sell 
(trade exit) occurs. 

Note that trade arrows represent all possible trades taken. Given trade may not be taken by 
backtester if there are insufficient funds to enter it. 

• Show current trade arrows - show entry/exit arrows for selected trade only. This displays the arrows 
for currently selected trade (from the result list). It represents trade actually taken. 
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• Add all results to watch list - adds all symbols from the result list to the watch list of your choice. More 
on this here 

• Add selected results to watch list - adds symbols from selected rows to the watch list of your choice. 
More on this here 

• Replace watch list with all results - empties the watch list and then adds all symbols from the result list 
to the watch list of your choice. More on this here 

• Replace watch list with selected results - empties the watch list and then adds symbols from selected 
rows to the watch list of your choice. More on this here 

• Clear result list - removes all rows from the result list 

• Copy - copies result list to the Windows clipboard, so you can paste It to some other application, like 
Excel for example 

IMPORTANT NOTES: 

1. Buy arrow Is solid green. Sell arrow Is solid red. Short arrow Is hollow red. Cover arrow Is hollow green 

2. Arrows are shown only on the charts that have "Show arrows" property turned ON. 
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Chart context menu 


Parameters 

ttrl+R 

Edit formula 

Close 

arl+E 

Intraday 
' Daily view 

arl+D 

' Weekly view 

ari+w 

' Monthly view 

arl-i-M 

Pane 


Template 


Delete indicator 

Delete study 

Dejete all studies 


gf* Properties... Att+Enter 


This context menu shows up when you click with RIGHT mouse button over chart pane. 

Available options: 

• Parameters... - brings up Parameters dialog allowing you to modify parameters of indicators, as well 
as colors, styles, scaling and axes settings 

• Edit Formula... - brings up Formula Editor allowing you to view/modify the AFL code of indicator 

• Close - closes chart pane 

• Intraday ... - allows you to switch viewing time frame to one of available intraday intervals 

• Daily view - switches viewing interval to daily 

• Weekly view - switches viewing interval to weekly 

• Monthly view - switches viewing interval to monthly 

• Pane 

♦ Close - closes chart pane 

♦ Arrange all - arranges panes to equal height 

♦ Move up - moves selected chart pane up (switches pane vertical order) 

♦ Move down - moves selected chart pane down (switches pane vertical order) 

♦ Maximize - maximizes selected pane so it fills entire screen 

♦ Restore - restores selected pane to previous size 

• Template 

♦ Load... - loads single window chart template from the selected file (more on templates and 
layouts here) 

♦ Save... - saves single window chart template to the selected file 

♦ Load default - loads default single window template 

♦ Save as default - saves current single window setup as default template 

• Delete indicator - deletes one of drag-and-drop indicator sections found in the code 

• Delete study - deletes selected manually drawn study (like trend line, Fibonacci, Gann...) - more on 
this here 

• Delete All studies - deletes all manually drawn studies (like trend line, Fibonacci, Gann...) 

• Properties - displays properties (coordinates, colors, etc) of manually drawn study (like trend line, 
Fibonacci, Gann...) more on this here and here. 
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Layouts context menu 




X 


Symbols 


Layouts 


Layers Charts 


Id L_1 Lo cal layo uts 

^ ^ Open 

♦ Di - 

# Pi Save 

a L_1 Globe Save As... 

Save as default 


Delete 


Layouts context menu shows up when you click with RIGHT mouse button over layout in the Workspace 
window, Layouts tab. 

Available choices: 

• Open - loads selected layout 

• Save - saves current window layout under current name 

• Save As... - save current window layout under new name 

• Save as default - save current window layout as default (startup) layout for given database 

• Delete - delete selected layout 


To learn more about Layouts please check Tutorial: Chart sheets and layouts 
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Formula (chart) context menu 


Charts 

I? X 

ft r~l Bands 

* 



f Bollinger Bands 



f Keltner Bands 



f Percent Bands 

E 

3 CJ Basic Charts 



f Open Interest (futures) 



f 

]_Li 



f Pric 

Insert 



/ Pric 

Insert Linked 



f Reic 




f Voli 

Overlay 



f Volt 

Analysis 



f Voli 




f Voli 

Edit 


f Bollingi 

Rename 

E 

3 LJ Custorr 

Delete 



f My 




/ Unr 

New ► 



f Unr 




f Unn 

Refresh 


Formula (chart) context menu shows up when you click with RIGHT 
mouse button over formula listed in the Charts tab of Workspace pane 
(see picture on the left) 


Available choices: 

• Insert - inserts selected indicator into new chart pane. 

Insert command internally creates a copy of the original formula file and places such copy into hidden 
drag-drop folder so original formula will not be affected by subsequent editing or overlaying other 
indicators onto it. 

Double clicking on formula name is equivalent with choosing Insert command from the menu. 

• Insert Linked - inserts selected indicator into new chart pane directly (i.e. linked to original). 

Insert Linked command does not create any copy of the formula. Instead it creates new chart pane 
that directly links to original formula. This way subsequent editing and/or overlaying other indicators 
will modify the original 

• Overlay - overlay selected indicator onto selected chart pane 

Overlay command internally appends additional code to the formula used by the chart pane. If given 
chart pane was created usign Insert Linked, it will modify original (linked) formula. 

• Analysis - show up Automatic Analysis window and pick selected formula 

• Edit - open Formula Editor window to edit selected formula 

• Rename - rename currently selected formula file 

• Delete - delete currently selected formula file 

• New 

♦ Formula - creates new formula file in currently selected folder 

♦ Folder - creates new subfolder under currently selected folder 

• Refresh - re-reads Formula directory and re-display formula tree 
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Layers context menu 


X 



Layers context menu shows up when you click with RIGHT mouse button 
over layer list in the Layers tab of Workspace pane. 


Available options: 

• Add layer - adds new layer 

• Remove layer - removes selected layer. 

Please note that you can not remove first 5 (built-in) layers 

• Show All - shows all not locked layers 

• Hide All - hides all not locked layers 

• Toggle - toggles visibility of not locked layers 

• Lock bullt-ln layers - allows you to lock 5 first (bullt-ln) layers. When layer Is locked Its visibility changes 
automatically when Interval changes and you can not show/hide It manually. 

• Unlock bullt-ln layers - allows you to unlock 5 first (bullt-ln) layers. Once layer is unlocked Its visibility does not 
change automatically when Interval changes and you can show/hide it manually. 

• Properties - 

this launches properties box that allows you to rename layer and decide if given layer should or should not be locked to 
Interval displayed. If you mark "Lock visibility to Interval" box the layer will show/hide automatically depending on what 
Interval Is 

currently displayed. You can define visibility for each layer using "Interval" combo and "Show/hide automatically" buttons. 
Note that there is a 'separate* visibility setting for EACH interval. The layer properties box ALWAYS shows "monthly" 
Interval at start but this Is just a startup condition you just switch to particular interval 

and modify visibility. To setup locked layer completely you have to set visibility for every layer listed In the "Interval" 
combo-box. Simply select the interval and choose If layer should be shown or hidden for this Interval, select next Interval 
and again choose show or hide, select next and so on...until you define visibility for all Intervals. 


More information about what layers are and how to use them is in the Tutorial: Using Layers section of the 
guide. 
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Real-time quote context menu 


ReaMne Quote I 

Ticker 

Open 

High 

Lov,? 

Last Change 

% Ch... 

Volume Trc 

$INDU 

12,620.90 

12,621... 

12,46... 

12,47... -145.99 

-1.16% 

190,208,432 

AA 

40.54 

41.00 

39.78 

40.25 -0.55 

-1.35% 

12,594,454 

Iaxp 





-1.96% 

8,456,140 i 

BA 

81.21 

82.09 

80. 

1 irilc ot bdlcSi.. 

+0.09% 

4,476,576 

C 

21.75 

21.79 

21. _ 


-2.76% 

65,579,320 

AAPL 

180.77 

181.99 

177. 

Add symbol 

+2.33% 

32,440,244 

CNET 

11.42 

11.45 

11. 

Add watch list... 

-0.26% 

1,607,406 

QCOM 

45.78 

48.10 

45. 

Type-in symbolfs) 

+4.12% 

28,220,481 

ADBE 

40.88 

41.53 

40. 

Insert empty line 

-0.36% 

3,645,325 1 

CNXT 

0.46 

0.47 

0.— 


-3.72% 

1,327,934 

LLTC 

35.95 

36.34 

35. 

Remove symbol 

-1.59% 

10,008,163 

QLGC 

15.52 

15.74 

15. ~ 

Remove All 

-0.70% 

1,697,916 1 

ADCr 

15.03 

15.37 

14. _ 

+0.00% 

2,586,111 I 

COMS 

2.40 

2.48 

2. 

Hide 

+0.41% 

2.773.398 3^ 

n > H \ List 1/List 2 \ List 3 \ List 4 \ 

List 5 \ List 6 



XLIStllX 

List 12 \ List 13 \ List 


Time & Sales 

Opens Time & Sales window that provides information about every bid, ask and trade streaming from the 
market. 

Easy Alerts 

Opens Easy Alerts window that provides way to define realtime alerts executed when bid/ask/last and other 
fields hit user-defined levels 

Add Symbol 

Adds current symbol to Real-Time Ouote list 

Add watch list... 

Adds entire watch list to real-time quote window 

Type-in symbols 

Allows to type the symbols directly as comma-separated list 

Insert empty line 

Adds empty (separator) line - useful for grouping symbols 

Remove Symbol 

Removes highlighted line (symbol) from the Real-Time Ouote list. 

Remove All 

Removes all symbols from real-time quote list 

Hide 

Hides Real-Time Ouote list 
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Keyboard shortcuts 

AmiBroker allows complete customization of the user interface, including keyboard shortcuts. To define your 
own shortcuts use Tools->Customize menu, Keyboard tab. Read more about it in the Tutorial: User 
Interface Customization. 


Pre-defined keyboard shortcut list follows below, please note that if you used keyboard customization features 
the list here may not be valid because some of the entries may have been changed to your own. 


Keyboard shortcut 

Command 

CTRL+0 

VIEW_HOURLY 

CTRL+1 

VIEW_1 MINUTE 

CTRL+5 

VIEW_5MINUTE 

CTRL+6 

VIEW_15MINUTE 

CTRL+C 

EDIT_COPY 

CTRL+D 

VIEW_DAILY 

CTRL+E 

CHART_EDITFORMULA 

CTRL+H 

VIEW_CROSSHAIR 

CTRL+I 

CHART_MORE_INDICATORS 

CTRL+M 

VIEW_MONTHLY 

CTRL+N 

FILE_NEW 

CTRL+0 

FILE_OPEN 

CTRL+P 

FILE_PRINT 

CTRL+R 

CHART_PARAMETERS 

CTRL+S 

FILE_SAVE 

CTRL+V 

EDIT_PASTE 

CTRL+ADD (CTRL+'+') 

VIEW_ZOOM_IN 

ALT+BACK 

EDIT_UNDO 

DELETE 

EDIT_CLEAR 

ALT+DELETE 

EDIT_CLEAR_ALL 

SHIFT+DELETE 

EDIT_CUT 

END 

CHART_SCROLL_END 

F1 

HELP 

SHIFT+F1 

CONTEXT_HELP 

F12 

CHART_RANGE_BEGIN 

CTRL+F12 

CHART_RANGE_HIDE 

SHIFT+F12 

CHART_RANGE_END 
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F3 

STOCK_FIND 

F4 

QUICK_FIND 

F5 

VIEW_REFRESH_CHARTS 

F6 

NEXT_PANE 

SHIFT+F6 

PREV_PANE 

HOME 

CHART_SCROLL_BEGIN 

CTRL+INSERT 

EDIT_COPY 

SHIFT+INSERT 

EDIT_PASTE 

ALT+LEFT 

SYMBOL_PREV 

CTRL+ALT+LEFT 

VIEW_GO_PREV 

SHIFT+ALT+LEFT 

SYMBOL_PREV_TREE 

PAGE_DOWN 

CHART_SCROLL_PAGE_RIGHT 

CTRL+PAGE_DOWN 

VIEW_SHEET_NEXT 

PAGE_UP 

CHART_SCROLL_PAGE_LEFT 

CTRL+PAGE_UP 

VIEW_SHEET_PREV 

ALT+RETURN 

CHART_STUDY_PROPERTIES 

ALT+RIGHT 

SYMBOL_NEXT 

CTRL+ALT+RIGHT 

VIEW_GO_NEXT 

SHIFT+ALT+RIGHT 

SYMBOL_NEXT_TREE 

CTRL+SUBTRACT (CTRL+'-') 

VIEW_ZOOM_OUT 

CTRL+W 

VIEW_WEEKLY 

CTRL+X 

EDIT_CUT 

CTRL+Z 

EDIT_UNDO 
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Import ASCII 

AmiBroker has easy-to-use and flexible quotation import feature. This document describes advanced 
concepts of AmiBroker ASCII importer. Novice users should start with ASCII Import Wizard. 

How does it work? 

Quotation data may come from various sources so the format of the ASCII (i.e. text based) file may be much 
different from one source to another. To handle all those differences AmiBroker uses format definition 
commands that define the way the text information is interpreted by the ASCII importer. The format definition 
commands are keywords that begin with a dollar sign '$'. These commands may be embedded in the data file 
itself or, may be stored in the separate format definition file for multiple use. Storing format definition 
commands in separate file avoids the need to include the commands in every data file. The default format 
definition file name is "default.format". This file, all other ".format" files and "import.types" file (described later) 
should be stored in \Formats subdirectory of AmiBroker's current working directory. The defaults are 
overridden by any commands included (embedded) in the data file itself. 

So, when you use the "Import from ASCII" menu, AmiBroker first looks for the format definition stored in 
"default.format" file and then parses the file you have chosen. If there is no "default.format" file then it uses 
internal defaults (described below). 

You can modify "default.format" file to suit your needs. Moreover using OLE Automation (Win32 version) or 
ARexx (Amiga) interface you can specify the name of the format definition file which will be used instead of 
"default.format" file. 

Format definition commands 

The command keywords begin with a dollar sign '$". Every line starting with command is interpreted in special 
way. Here is the list of commands recognized by AmiBroker's built-in importer. Bold letters mark keywords. 


Command 

$ADDRESS 

Define company address 

Arguments 

<string> 

address of company 

Alias 


Examples 

$ADDRESS "One Microsoft Way" 


Command 

$AUTOADD 

Switch new ticker add mode 

Arguments 

<number> 

0 - do not add , 1 - add a new stock when 
non-existing ticker detected (default = 0) 

Alias 


Examples 

$AUTOADD 1 


Command 

$ALLOWNEG 

Allow negative numbers in prices 

Arguments 

<number> 
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0 - do not allow negative values (default), 

1 - allow negative values In prices. This 
additionally switches off any checking for 
OHLC relationship so you can Import any 
data Into OHLC fields. 

when $ALLOWNEG Is NOT specified In 
the ASCII Importer definition AmiBroker 
performs the following range checking 
and fixup on open, low and high prices 
lf( open == 0 ) open = close; 
lf( high < max( open, close )) high = max( 
open, close); 

if( low == 0 ) low = mln( open, close ) 


Alias 

Examples 


$ALLOWNEG 1 


Command 

$ALLOW99SECONDS 

Convert Invalid second stamp 

Arguments 

<onoff> 

This flag works ONLY In 
conjunction with $TICKMODE 1 
(see below for details) 



$ALLOW99SECONDS set to 1 will 
convert all records with Invalid 
seconds (I.e greater than 59)to 59s. 
So record stamped 16:29:70 will be 
treated as 16:29:59 

Alias 


Examples 

$ALLOW99SECONDS 1 


Command 

$APPENDNAME 

append string to the ticker name (useful 
when you need to join several fields 
together to make unique stock symbol) 

Arguments 

<strlng> 

string to append to the ticker symbol 

Alias 

$APPENDTICKER 

Examples 



Command 

Arguments 

Alias 


$BREAKONERR 

Define on-error behaviour 

<number> 

0 - to continue, 1 - to break Import on 
error (default=0) 
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Examples 


$BREAKONERR 1 


Command 

Arguments 


Alias 

Examples 


$CONT 

Define continuous quotations fiag 

<number> 

<0 or 1> - continuous quotations fiag, this 
affects $AUTOADD 1 mode - if this is set, 
newiy added stocks are switched to 
continuous quotation mode (this means 
enabiing candiestick charts for example) 


$CONT1 


Command 

$CURRENCY 

Define symbol's currency 

Arguments 

<string> 

Defines currency of symbol 

Alias 


Examples 

$CURRENCY EUR 


or 



$FORMAT NAME, CURRENCY 
$OVERWRITE 1 
$AUTOADD1 


Command 

$DATE_DMY 

Define date 

Arguments 

<number> 

The date in Canadian format 
(DD-MM-YY). If there is no argument 
given the date is taken from the file name 
(without an extension) 

Alias 

$DATE_CDN 

Examples 

$DATE_DMY 12-05-99 
$DATE_CDN 12-05-1999 


Command 

$DATE_MDY 

Define date 

Arguments 

<number> 

The date in US format (MM-DD-YY). If 
there is no argument given the date is 
taken from the file name (without an 
extension) 

Alias 

$DATE_USA 


Examples 

$DATE_MDY 05/12/99 


$DATE USA 05/12/99 
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Command 

$DATE_YMD 

Define date 

Arguments 

<number> 

The date in Internationai format 
(YY-MM-DD). If there is no argument 
given the date is taken from the fiie name 
(without an extension) 

Alias 

$DATE_INT 

Examples 

$DATEJNT 99-05-12 
$DATE_CDN 1999.05.12 


Command 

$DEBUG 

Switch logging (debug) mode 

Arguments 

<number> 

0 - no error logging, 1 - log errors to 
"import.log" file (default=0) 

Alias 


Examples 

$DEBUG 1 


Command 


Arguments 


$FORMAT 

Define line format 
(sequence and types of 
fields) 

DATE_MDY 

date in US format: 
MM-DD-YY (alias: 

DATE_USA) 

DATE_DMY 

date in Canadian format: 
DD-MM-YY (alias: 

DATE_CDN) 

DATE_YMD 

date in International 
format: YY-MM-DD (alias: 

DATEJNT) 

TIME 

time in HH:MM:SS or 
HH:MMorHHMMor 

HHMMSS format 

NAME 

ticker name (alias: 

TICKER) 

ALIAS 

symbol alias ($AUTOADD 
and SOVERWRITE 
modes only) 

FULLNAME 

symbol full name 
(SAUTOADD and 
SOVERWRITE modes 
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only) 


open price 


high price 


low price 

CLOSE 

close price 

ADJCLOSE 

split-adjusted close 

This is provided to read 
adj. close column from 
Yahoo. Works only in 
conjunction with CLOSE 
field. When both CLOSE 
and ADJCLOSE are 
present in the ASCII 
format definition then 
importer calculates split 
factor by dividing 
ADJCLOSE/CLOSE. It 
then multiples OPEN, 
HIGH, LOW and CLOSE 
fields by this factor and 
divides VOLUME field by 
this factor. This effectively 
converts unadjusted 
prices to split adjusted 
prices. Split ratio gets 
locked once ADJCLOSE 
drops below 0.05. 

OPENINT 

open interest 

VOLUME 

volume 

^^^^|vOL1000 

volume in thousands 
shares 

^^^^|vOLMIL 

volume in millions shares 

VOLFACTOR 

volume factor (number of 
shares in a block) default 
=1 

TURNOVER 

turnover 


AUX1 field (auxilliary 
data) 

^^^^^AUX2 

AUX2 field (auxilliary 
data) 


skip (ignore) field 

MARKET 

specify a field that 
contains market ID 
(affects SAUTOADD and 
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SOVERWRITE modes 
only) 

GROUP 

specify a field that 
contains group ID (affects 
SAUTOADD and 
SOVERWRITE modes 
only) 

WATCHLIST 

specify a field that 
contains watch list 
number (0-31) (affects 
SAUTOADD and 
SOVERWRITE modes 
only) 


specify a field with 
additional information 
(WSE specific: nk, ns, rk, 
rs, ok, os, zd, bd ) 

REDUCTION 

specify a field with 
reduction rate in percents 
(WSE specific) 


(new in 5.60) 

specify ICB code 

For example if your file 
looks as follows: 

(format is symbol, full 
name, ICB code) 
AAN,AARON'S INC,5375 

Then to import it usign 
AmiBroker's import 
wizard use the following 
SFORMAT 

Ticker, FullName, ICB 
SOVERWRITE IS 
SSEPARATOR, 

SCONT 1 

SGROUP255 

SAUTOADD 1 
SNOOUOTES 1 


specify GICS code 

For example if your file 
looks as follows: 

(format is symbol, full 
name, gics sub industry 
code) 

AAN,AARON'S 


Format definition commands 


439 











AmiBroker 6.00 User's Guide 


AmiBroker Reference Guide 




INC,25504060 


Then to import it usign 
AmiBroker's import 
wizard use the following 
SFORMAT 

Ticker, FullName,GIGS 
SOVERWRITE 1$ 
SSEPARATOR, 

$CONT 1 
$GROUP255 

SAUTOADD 1 
SNOQUOTES1 

INDUSTRY 

specify a field that 
contains industry ID 
(affects $AUTOADD and 
SOVERWRITE modes 
only) 

INDUSTRYNAME 

(new in 5.60) specifies a 
field that contains 

Industry Name. 

AmiBroker will check if 
given industry name 
already exists and if not, it 
will create a new Industry 
and assign imported 
stock to the industry 
specified. Also if 
SECTORNAME is 
specified, it will assign 
newly added industry to 
specified sector. 


(affects SAUTOADD and 
SOVERWRITE modes 
only) 

SECTORNAME 

(new in 5.60) specifies a 
field that contains Sector 
Name. AmiBroker will 
check if given sector 
name already exists and 
if not, it will create a new 
Sector. Also if 
INDUSTRYNAME is 
specified, it will assign 
newly added industry to 
specified sector. 


(affects SAUTOADD and 
SOVERWRITE modes 
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only) 

APPENDTICKER 

specify a field that 
contains string that 
should be appended to 
the ticker name (useful 
when you need to join 
several fields together to 
make unique symbol 
symbol) 

MARGIN 

future contract margin 
deposit (positive value = 
dollars, negative value - 
percent of full value) 

POINTVALUE 

future contract point value 

ROUNDLOTSIZE 

round lot size (trading unit 
size) 

TICKSIZE 

tick size 

ADVISSUES 

number of advancing 
issues 

AD VVOLU ME 

volume of advancing 
issues 

DECISSUES 

number of declining 
issues 

DECVOLUME 

volume of declining 
issues 

UNCISSUES 

number of unchanged 
issues 

UNCVOLUME 

volume of unchanged 
issues 

ADDRESS 

street address of 

company 

CURRENCY 

specifies currency of 
symbol 

DIV_PAY_DATE 

EX_DIV_DATE 

LAST_SPLIT_DATE 

LAST_SPLIT_RATIO 

^^^^Heps 

EPS_EST_CUR_YEAR 

EPS_EST_NEXT_YEAR 

EPS_EST_NEXT_QTR 

FORWARD_EPS 

PEG_RATIO 

^^^^HbOOK_VALUE (requires 
^^^^^^|sHARES_OUT to be specified 
as 

fundamental data fields. 
For more info read Using 
Fundamental Data 
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Alias 

Examples 


BOOK_VALUE_PER_SHARE 

EBITDA 

PRICE_TO_SALES (requires 
CLOSE to be specified as weil) 
PRICE_TO_EARNINGS 
(requires CLOSE to be specified 
as weii) 

PRICE_TO_BV (requires 
CLOSE to be specified as weii) 

FORWARD PE (requires 
CLOSE to be specified as weii) 

REVENUE 

SHARES_SHORT 

DIVIDEND 

ONE_YEAR_TARGET 
MARKET CAP (requires 
CLOSE to be specified as weii - 
it is used to calculate shares 
outstanding) 

SHARES_FLOAT 

SHARES_OUT 

PROFIT_MARGIN 

OPERATING_MARGIN 

RETURN_ON_ASSETS 

RETURN_ON_EQUITY 

QTRLY_REVENUE_GROWTH 

GROSS_PROFIT 

QTRLY_EARNINGS_GROWTH 

INSIDER_HOLD_PERCENT 

INSTIT_HOLD_PERCENT 

SHARES_SHORT_PREV 

FORWARD_DIV 

OPERATING_CASH_FLOW 

FREE_CASH_FLOW 

BETA 


$FORMAT TICKER DATE_MDY OPEN HIGH LOW 
CLOSE VOLUME 

$FORMAT TICKER, DATEJNT, CLOSE, VOLUME 
$FORMAT SKIP, TICKER, SKIP, SKIP, DATEJNT, OPEN, 
HIGH, LOW, CLOSE, TURNOVER 


Command 

$FULLNAME 

Define full symbol name 

Arguments 

<string> 

full symbol name 

Alias 


Examples 

$FULLNAME Apple Computer Inc. 
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Command 

$GICS 

Define GICS code (Global Industry 

Category System) 

Arguments 

<number> 

this affects SAUTOADD 1 and 
SOVERWRITE 1 modes - if this is specified 
symbols are assigned to given GICS 
category 

Alias 


Examples 

Now you can import GIGS symbol-code assignments using 
ASCII importer. 

SFORMAT command now supports GIGS code 
and there is $GICS command for single-symbol files. 


For example if your file looks as follows: 

(format is symbol, full name, gics sub industry code) 
AAN,AARON'S INC,25504060 


Then to import it usign AmlBroker's import wizard use the 
following 

SFORMAT Ticker,FullName,GICS 

SOVERWRITE 1$ 

SSEPARATOR , 

SCONT 1 
$GROUP255 

SAUTOADD1 

SNOQUOTES1 


Command 

SGROUP 

Define group ID 

Arguments 

<number> 

this affects SAUTOADD 1 mode - if this is 
specified, newly added symbols are 
assigned to group with given number. 

Alias 


Examples 



Command 

SHYBRID 

Switch hybrid mode on/off 

Arguments 

<number> 

0 (off) or 1 (on). When this flag is set, you 
can combine quotations from multiple files - 
for example one file can contain only open 
prices and volume and the other file can 
contain high/low/close data. Useful 
especially for Warsaw Stock Exchange for 
combining the data from fixing and later 
continuous quotations. 

Alias 


Examples 
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Command 

$INDUSTRY 

Define industry ID 

Arguments 

<number> 

this affects $AUTOADD 1 mode - if this is 
specified, newiy added symbols are 
assigned to industry with given number. 

Alias 


Examples 



Command 

$MARKET 

Define market ID 

Arguments 

<number> 

this affects $AUTOADD 1 mode - if this is 
specified, newly added symbols are 
assigned to market with given number. 

Alias 


Examples 



Command 

$NAME 

Define ticker name 

Arguments 

<ticker> 

ticker name (symbol) (default = file name 
without path and extension) 

Alias 

STICKER 

Examples 

$NAME AAPL 



STICKER MSFT 


Command 

Arguments 


Alias 

Examples 


SNOQUOTES 

Switch quotation data mode 

<number> 

0 - (default) accept only quotation data 
(AmiBroker checks for non-zero prices 
and valid dates) 

1 - switch off quotation data checking - 
this allows importing non-quotation data - 
for example only ticker and full names 

STICKER 

SNAME AAPL 

STICKER MSFT 


Command 

Arguments 


SOVERWRITE 

Switch overwrite mode on/off 

<number> 

0 - off, 1 - on. When overwrite mode is on 
then information provided by GROUP, 
MARKET, INDUSTRY, FULLNAME fields 
is overwritten for existing symbols (not 
only for newly added) 
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Alias 


Examples 

$OVERWRITE 1 


Command 

$PRICEFACTOR 

Define price factor 

Arguments 

<number> 

the factor by which price data are 
muitipiied (defauit = 1) 

Alias 


Examples 

$PRICEFACTOR 100 


Command 

$RAWCL0SE20I 

Put Raw Close price to 01 field 

Arguments 

<number> 

0 - off, 1- on. (off by default) - causes 
that Openinterest field gets assigned 
CLOSE (raw close) field value 
multiplied by 100 

Alias 


Examples 

$RAWCL0SE20I 1 


Command 

Arguments 


$RECALCSPLITS 

Recalculate splits 

<number> 

0 - off, 1 - on. (off by default) causes 
that splits are recalculated by 

AmiBroker 

by the algorithm that tries to construct 
correct adjusted price, based on 
inaccurate information provided by 
Yahoo. 

Note that Yahoo provides only 2 
decimal digits in adj. close field 
therefore the more adj. close 
approaches zero due to adjustements 
the error grows. The option 
$RECALCSPLITS 1 is intended to 
address this problem (at least partially). 

It works as follows: 

1. for each bar ratio 

ADJCLOSE/CLOSE is calculated 

2. if the ratio changes in two 
consecutive bars by more than 10% it 
means that 

split happened that bar. True split ratio 
is guessed by matching true fraction 
in the format of X/Y, where X and Y = 

1 ..9, to the change in ratios. 

3. Then true split ratio is used to adjust 
all past bars until new split is detected. 
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Alias 


Works only in conjunction with 
ADJCLOSE 


Examples 

$RECALCSPLITS 1 


Command 

Arguments 

Alias 

Examples 


$RECALCVOL 

Switch automatic index volume 
recalculation 

<number> 

0 - off, 1 - on (base index only), 2 - on (all 
indexes). When this is on AmiBroker 
calculates volumes for indexes based on 
assignments to markets and base 
indexes defined in Categories window 


$RECALCVOL 2 


Command 

$RECALCAD 

Switch automatic advance/decline 
composite recalculation 

Arguments 

<number> 

0 - off, 1 - on. When this is on AmiBroker 
calculates numbers and volumes of issues 
advancing, declining and unchanged 
based on assignments to markets and 
base indexes defined in Categories 
window. 

Alias 


Examples 

$RECALCVOL 2 


Command 

$ROUNDADJ 

Round split adjusted prices to given 
number of decimaldigits 

Arguments 

<decimaldigits> 

decimaldigits - causes split-adjusted 
prices (see above) to be rounded to 
'decimaldigits' precision. By default no 
rounding is done 



Works only in conjunction with 

ADJCLOSE 

Alias 


Examples 

$ROUNDADJ 2 
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Command 

SSEPARATOR 

Define field separator character 

Arguments 

<separator char> 

the character used to separate data 
fields (default = space) 

Alias 


Examples 

SSEPARATOR, 

SSEPARATOR ; 


Command 

SSKIPLINES 

Define how many lines to skip (ignore) 

Arguments 

<number> 

number of lines to skip (default = 0) 

Alias 


Examples 

SSKIPLINES 1 


Command 

SSTRICT 

Switches on/off strict checking if Open, 

High, Low prices are greater than zero 

Arguments 

<onoff> 

(default = 0) 

Alias 


Examples 

SSTRICT 1 


Command 


$TICKMODE 


Switches on/off tick mode 


STICKMODE is a speciai mode of importer that aiiows to import quotes that havec 


It makes two assumptions: 

a) input data shouid come in the ascending time order (i.e. OLDER records first, L 

b) input data shouid consist of entire tick history because importer wili DELETE ar 

Once again: Turning on 
STICKMODE 1 

will DELETE ANY OUOTES that already exist in the database and then will imporl 
You have been warned. 


For example data files like this: 

MOL,0,20050606,162959,16400.0000,16400.0000,16400.0000,16400.0000,2MO 


Can be imported using the following definition file: 


SFORMAT Ticker, Skip, Date_YMD, Time, Open, High, Low, Close, Volume 
SSKIPLINES 1 
SSEPARATOR, 
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$CONT1 
$GROUP255 
$AUTOADD1 
$DEBUG 1 
$TICKMODE 1 

Sometimes it happens that input fiies have invaiid timestamps (seconds > 59). 

For exampie: 

MOUO,20050606,162970,16400.0000,16400.0000,16400.0000,16400.0000,2 

Please take a closer look at first line shown in this example it has time:16:29:70 (y 

So 1 had to add a special flag to the importer that works around such data errors. 

It is called $ALLOW99SECONDS 1 and will convert all records with invalid seconc 
So record stamped 16:29:70 will be treated as 16:29:59 

Now for tick mode to work with such incorrect records you would need to add two 

STICKMODE 1 
$ALLOW99SECONDS 1 

Arguments 

<onoff> 

(default = 0) 

Alias 



Examples 

$TICKMODE 1 


Command 

STIMESHIFT 

Define intraday time shift used during 
import 

Arguments 

<number> 

number of hours to shift date/time stamps 
(can be fractional) 

Alias 


Examples 

STIMESHIFT 2 

; will shift 2 hours forward 


STIMESHIFT -11.5 

; will shift 11 and half hour backward 


Command 

SVOLFACTOR 

Define volume factor 

Arguments 

<number> 

the factor by which volume data is 
multiplied (default = 1) 
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Alias 


Examples 

$VOLFACTOR 10 


Command 

$WATCHLIST 

Define watch list number 

Arguments 

<number> 

this affects $AUTOADD 1 and 
SOVERWRITE 1 modes - if this is 
specified, newly added symbols are 
added to the watch list with given 
number. 

Alias 


Examples 



Command 

Arguments 


Alias 

Examples 


$CLEANSECTORS 

Clean (wipe) existing sector/industry 
structure 

<number> 

if this is turned on (1), existing sector/ 
industry structure will be deleted and 
initialized with Sector 0, 1,2, 3...63/ 
Industry 0...255 

This command should only be used in 
conjunction with SECTORNAME, 
INDUSTRYNAME $FORMAT fields to 
allow setting up fresh industry 
structure 


See example below (importing sector/industry structure) 


Command 

Arguments 


Alias 

Examples 


$SORTSECTORS 

Sort sector/industry structure 

<number> 

if this is turned on (1), sector/ industry 
structure will be sorted alphabetically 
after importing. 

This command should only be used in 
conjunction with SECTORNAME, 
INDUSTRYNAME $FORMAT fields to 
allow setting up fresh industry structure 


See example below (importing sector/industry structure) 


Command 

SUSEONLYLOCALDB 

Switches "Use only local database" 
option for the symbol 

Arguments 

<number> 

If data is fed by database plugin, 
using the ASCII importer to add any 
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symbol causes these newly added 
symbol to have "Use only local 
database" flag turned on. 

A new command: 
SUSEONLYLOCALDB 0 


allows to turn this off (so newly 
added symbols have "use only local 
database" turned off) 


This flag does NOT affect existing 
symbols. 


Notes: 


• for DATE_xxx you can use -, / or \ as day/month/year separators. You can even omit 
separators at all If only you give a date In a 6 digit (YYMMDD, MMDDYY, DDMMYY) or 8 digit format 
(YYYYMMDD, MMDDYYYY, DDMMYYYY). 

• AmiBroker recognizes decimal as well as true fractions In price data. True fractions must follow the 
whole value after at least single space. For example you can specify: 5.33 or 5 1/3 

AmiBroker Is not limited to any kind of fraction, If you wish you can write even: 5 333/999 

Comments 

You can Include comments In both format definition file and the data flle(s). Each line starting with * (asterisk) 
or; (semicolon) or # (hash) Is treated as a comment and Ignored by the ASCII Importer. 

Usage examples 

What may look complicated from command list will become quite clear after some examples. So I will give you 
four examples of how to write format definition files. First example will show the definition for CSV (comma 
separated values) quotes available from Yahoo's finances site. Second example will show definition for 
Metastock ASCII file format. Third example shows definition for Omega SuperCharts ASCII file format. And 
fourth example will show the definition for s-flles used by DM BOS (Polish brokerage company). 

Yahoo CSV 

The data from Yahoo's site looks as follows: 

Date, Open, High,Low,Close,Volume 

1-Feb- 0,104,105,100,100.25,2839600 

31-Jan- 0,101,103.875,94.50,103.75,6265000 

28-Jan- 0,108.1875,110.875,100.625,101.625,3779900 
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The first line gives us a hint about the meaning of the comma separated fields. First field will hold the date. 

The remaining fields will hold open, high, low, close prices and volume. Importer should skip the first line and 
parse all the remaining lines that hold just comma-separated data. Appropriate format definition file would look 
like this: 

SFORMAT Date_DMY,Open,High,Low,Close,Volume 
$SKIPLINES 1 
$SEPARATOR , 

SDEBUG 1 
$AUTOADD 1 
$BREAKONERR 1 

SDEBUG switches on error logging to "import.log" file and SBREAKONERR will cause importer to stop after 
the first error found. SAUTOADD ensures that new ticker will be added to the database if it is missing. Well... 
you may ask: how does it know the ticker name? The answer is simple: if there is no field which defines the 
ticker name, the importer takes the file name (without path and extension) as a ticker. So if you are importing 
file "C:\My data\AAPL.CSV" AmiBroker will use "AAPL" as a ticker name. 

Metastock ASCII 

The data in Metastock ASCII format looks as follows: 

<ticker>,<per>,<date>,<high>,<low>,<close>,<vol> 

AAP,D,1/17/2000,5483.33,5332.01,5362.3,0 
AKS,D, 1/17/2000,9868.45,9638.03,9687.62,0 
FET,D,1/17/2000,3741.3,3540.2,3570.81,0 

First field will hold the ticker name, second - time period ("D" means daily data), third - quotation date. The 
rest will hold high, low, close prices and volume. The importer should then skip the first line and parse all the 
remaining lines that hold just comma-separated data. Appropriate format definition file would look like this: 

SFORMAT Ticker,Skip,Date_MDY,High,Low,Close,Volume 
SSKIPLINES 1 
$SEPARATOR , 

SDEBUG 1 
SAUTOADD 1 
SBREAKONERR 1 

Skip in SFORMAT defines a field which should be ignored by the importer. 

Omega SuperCharts ASCII 

The data in Omega SC ASCII format looks as follows: 

ticker,date,open,high,low,close,vol 

AAP,20000117,5333.01,5483.33,5332.01,5362.3,3433450 

This format is similar to previous ones, however the date is in YYYYMMDD format without separators 
between year, month and day part. AmiBroker, however, can handle such dates with ease. Appropriate format 
definition file would look like this: 
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SFORMAT Name,Date_Int,Open,High,Low,Close,Volume 
$SEPARATOR , 

SDEBUG 1 
$SKIPLINES 1 
$AUTOADD 1 
SBREAKONERR 1 

Skip in SFORMAT defines a fieid which shouid be ignored by the importer. 

DMBOS S-files 

The data in this format iooks as foiiows: 

0,29-02-00,12:05,MIDWIG,1069.1,,,+1.2,336002000, 

0,29-02-00,12:05,NIF,48.6,,,+0.8,1763000, 

0,29-02-00,12:05,WIG20,2300.3,,,+1.1,336002000, 

0,29-02-00,12:05,WIG,21536.8,,,+0.2,336002000, 

0,29-02-00,12:05,WIRR,2732.8,,,+1.6,16373000, 

1.29- 02-00,12:05,AGORA,144.00,,,+4.7,15802000, 

1.29- 02-00,12:05,AGROS,40.00,nk,72,+5.0,840000, 

1.29- 02-00,12:05,AMERBANK,28.00,,,+3.7,22000, 

1.29- 02-00,12:05,AMIGA,41.50,nk,99,+2.2,564000, 

This format is a iittie bit more compiicated. For us usefui fieids are: 2nd - date, 4th - ticker, 5th - ciose price, 
9th - the turnover vaiue (ciose * voiume). The remaining fieids hoids other information that is not usefui for us. 
Appropriate format definition fiie wouid iook iike this: 

SFORMAT Skip,Date_DMY,Skip,Name,Close,Skip,Skip,Skip,Turnover 
$SEPARATOR , 

SDEBUG 1 

Importing Sector/Industry structure 

Let's assume we have a text fiie with Stock tickers, Fuii names. Sector name and industry name iisted iine by 
iine, as foiiows: 

"DDD","3D Systems Corporation","Technology","Computer Software: Prepackaged Software" 

"MMM","3M Company","Health Care","Medical/Dental Instruments" 

"SVN","7 Days Group Holdings Limited","Consumer Services","Hotels/Resorts" 

"AHC","A.H. Belo Corporation","Consumer Services","Newspapers/Magazines" 

"AIR","AAR Corp.","Capital Goods","Aerospace" 

"AAN","Aaron's, Inc.","Technology","Diversified Commercial Services" 

"ABB","ABB Ltd","Consumer Durables","Electrical Products" 

To import such file we use the following format definition: 

SFORMAT Ticker, FullName,SectorName,lndustryName 
SSEPARATOR , 

SAUTOADD 1 
SNOQUOTES 1 
SOVERWRITE 1 
SCLEANSECTORS 1 
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SSORTSECTORS 1 

$NOQUOTES 1 tells the Importer that we will be Importing non-quotation data. $AUTOADD 1/$OVERWRITE 
1 Is required to automatically add new symbols and overwrite existing symbol Information. $CLEANSECTORS 
1 wipes existing stock/Industry structure prior to Importing and $SORTSECTORS 1 - sorts sectors/industries 
after Importing so they will be listed In alphabetical order In the Symbol window. $FORMAT command just 
specifies the order and types of field to Import 

AmiBroker will read such ASCII file one-by one, then It will check whenever given sector name/industry name 
already exists, If not - It will create new sector/industry. Then It will assign given symbol to specified 
sector/industry. 

The result will be a database with new sector/industry structure being set up and symbols assigned to proper 
sectors and Industries. 

Described functionality Is used to Implement Tools->Update US symbol list and categories tool. 

Default behaviour 

When Importing ASCII files, AmiBroker attempts to open "default.format" file (In the AmIBroker's directory) to 
obtain the format definition. If such file Is missing the following default format Is applied: 

SFORMAT DATE_USA, OPEN, HIGH, LOW, CLOSE, VOLUME 
$SEPARATOR 

This means that by default ASCII Importer will use space character as a separator and will parse the following 
fields: date, open, high, low, close, volume. The file name (without path and extension) will be used as a ticker 
name. All other Import parameters ($DEBUG,$AUTOADD, etc.) are set to zero. 

User-definable file types and formats 

Now AmiBroker can use not only default.format definition file but also other user-specified files. File types, 
filters and format definition files are specified In import.types file (example Is Included In the update 
package). Now user can prepare/modify import.types file with the description of supported ASCII formats and 
filters to use. The format of import.types file Is: 

<Descriptive name>|<File filter>|<definition file name> 

Note vertical line characters between these three fields. Example Import.types file looks as follows: 

Default ASCII (*.*)|*.*|default.format 
Yahoo's CSV (*.csv)|*.csv|yahoo.format 
Metastock ASCII (*.mst)|*.mst|metastock.format 
Omega SC ASCII (*.txt) |*.txtI omega.format 
S-Files (s*.*) Is*.* Isfile.format 
C-Files (c*.*)Ic*.*tcfile.format 
Sharenet DAT (*.dat)|*.dat|dat.format 

If such file exists you will see your types In the "Files of type" combo-box and when you select one - 
appropriate filter will be used and after selecting some files and clicking OK - Importer will use specified 
".format" file. 
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In that way you can define as many text-based data formats as you like and AmiBroker will be able to 
"understand" them all. 

Ticker aliases 

Now each ticker can have an alias assigned, so the AmlBroker's built-in importers can recognize that security 
by both ticker symbol and alias names. This is useful when you are using two data sources that are using 
slightly different symbol naming convention or if you want to give the symbols more intuitive name while 
retaining the ability to use importers without problems. 

GICS categorisation 

GIGS is global industry classification standard, see 
http://en.wikipedia.org/wiki/Global_lndustry_Classification_Standard 
for more details on GICS system. 

GICS codes are from 2 to 8 digits. Such as 10 for energy sector or 351010 for "Health Care Equipment & 
supplies" industry. 

The codes are fixed even if new classifications are added at some point in the future. It is important to 
understand that these codes work in hierarchical way. 

NOTE: current databases DO NOT have GICS codes assigned to symbols. 

As far as I know PremiumData http://www.premiumdata.net/ is planning to release AmiBroker-compatible 
database with GICS support. 

AmiBroker now reads GICS.txt file from its installation folder. It contains GICS categories listed one by one in 

order of GICS code in the following format 

GICS;Name;Description<CRLF> 

GICS is numeric code from 2 digits upto 8 digits 
Name is GICS category name 
Description is GICS category description 
These fields must be separated by semicolon 

< CRLF> means carriage return/line feed characters (means "new line" - just press ENTER/RETURN key if 
you are editing with text editor) 

There must be only one category per line in GICS.txt file 
The default GICS.txt file is supplied already. 


ICB categorisation 

ICB stands for Industry Classification Benchmark 
(http://en.wikipedia.org/wiki/lndustry_Classification_Benchmark). 

AmiBroker allows also ICB 4-level classification system, but demo database does not have symbols classified 
according to that standard. You can find ICB classification codes in ICB.txt file inside AmiBroker folder. 
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NOTE: current databases DO NOT have ICB codes assigned to symbols. 

ICB classification for NYSE stocks can be imported from http://www.nyse.com/indexes/nyaindex.csv 

AmiBroker now reads ICB.txt file from its installation folder. It contains ICB categories listed one by one in 

order of ICB code in the following format 

ICB;Name<CRLF> 

ICB is numeric 4 digit code. 

Name is ICB category name 

These fields must be separated by semicolon 

< CRLF> means carriage return/line feed characters (means "new line" - just press ENTER/RETURN key if 
you are editing with text editor) 

There must be only one category per line in ICB.txt file 

The default ICB.txt file is supplied already. 
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AmiBroker's OLE Automation Object Model 

Important note about OLE automation: 

OLE automation interface is provided to controi AmiBroker from the OUTSiDE process (such as 
windows scripting host). While it is possible to access Broker.Application and underlying objects from AFL 
formulas you should be very careful NOT to touch any user interface objects (Documents, Document, 
Windows, Window , Analysis object) from AFL formula because doing so, you will be likely "Sawing Off the 
Branch You're Sitting On". Especially things like switching chart tabs from currently running chart formula are 
totally forbidden. Changing user interface objects via OLE from AFL that is currently running within those user 
interface parts is recipe for disaster. You have been warned. 


AmiBroker object model hierarchy. V5.50 



Index of objects 


• ADOuotation • Windows • Markets 

• ADOuotations • Commentary Ouotation 

• Analysis^) • Document • Ouotations 

• AnalysisDocf^) • Documents • Stock 

• AnalysisDocs*^^ Market • Stocks 

• Application 

• Window 

d) - Analysis object is obsolete as of 5.50. It is left here for backward compatibility and accesses Old 
Automatic Analysis window only 

(2) - AnalysisDoc object and AnalysisDocs collection are new objects introduced in v5.50 and allow to 
control New Analysis window 
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ADQuotation 

Properties: 

♦ Date As Date 

♦ Advissues As Long 

♦ AdvVolume As Single 

♦ Decissues As Long 

♦ DecVolume As Single 

♦ Uncissues As Long 

♦ UncVolume As Single 
Description: 

ADQuotation class keeps one bar of advance/decline information 

ADQuotations 

Methods: 

♦ Function Add(ByVal Date As Variant) As Object 

♦ Function Remove(ByVal Date As Variant) As Boolean 

Properties: 

♦ item(ByVal Date As Variant) As Object [r/o] [default] 

♦ Count As Long 

Description: 

ADQuotations is a collection of ADQuotation objects 

Analysis 

This object is obsoiete. it is provided oniy to maintain compatibiiity with oid code. 
Anaiysis object aiways accesses OLD Automatic Anaiysis. 

Properties: 

♦ Property Fiiter(ByVal nType As Integer, ByVal pszCategory As String) As Long [r/w] 

Methods: 

♦ Sub Backtest([ByVal Type As Variant]) 

♦ Sub CiearFiitersO 

♦ Sub Edit([ByVal bForceReioad As Variant]) 

♦ Sub ExpioreO 

♦ Function Export(ByVal pszFiieName As String) As Boolean 

♦ Function LoadFormuia(ByVal FiieName As String) As Boolean 

♦ Function LoadSettings(ByVal pszFiieName As String) As Boolean 

♦ Sub MoveWindow(ByVal Left As Long, ByVal Top As Long, ByVal Width As Long, 
ByVal Height As Long) 
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♦ Sub Optimize([ByVal Type As Variant]) 

♦ Function Report(ByVai pszFileName As String) As Booiean 

♦ Function SaveFormula(ByVai pszFileName As String) As Booiean 

♦ Function SaveSettings(ByVai pszFileName As String) As Booiean 

♦ Sub Scan() 

♦ Sub ShowWindow(ByVai nShowCmd As Long) 

♦ Sub SortByColumn(ByVai iColumn As Long, ByVal bAscending As Integer, ByVal 

bMultiMode As Integer) 

Properties: 

♦ RangeMode As Long 

♦ RangeN As Long 

♦ RangeFromDate As Date 

♦ RangeToDate As Date 

♦ ApplyTo As Long 
Description: 

Analysis object provides programmatic control of automatic analysis window 
Notes: 

Analysis.Backtest( Type = 2 ); - runs backtest 
Type parameter can be one of the following values: 

0 : portfolio backtest/optimize 

1 : individual backtest/optimize 

2 : old backtest/optimize 

IT IS IMPORTANT TO NOTE THAT FOR BACKWARD COMPATIBILITY REASONS THE 
DEFAULT BACKTESTER MODE 

IS "OLD" BACKTEST. THEREFORE YOU MUST SPECIFY TYPE = 0 IF YOU WANT TO 
GET PORTFOLIO BACKTEST. 

Analysis.Optimize(Type = 2 ); - runs optimization 
Type parameter can be one of the following values: 

0 : portfolio backtest/optimize 

1 : individual backtest/optimize 

2 : old backtest/optimize 

3 : walk-forward test (AmiBroker version 5.11.0 or higher) 

Analysis.Report( FileName: String ) - saves report to the file or displays it if FileName = "" 

Analysis.ApplyTo - defines apply to mode: 0 - all stocks, 1 - current stock, 2 - use filter 
Analysis.RangeMode - defines range mode: 0 - all quotes, 1 - n last quotes, 2 - n last days, 3 
- from-to date 

Analysis.RangeN - defines N (number of bars/days to backtest) 

Analysis.RangeFromDate - defines "From" date 
Analysis.RangeToDate - defines "To" date 

Analysis.Filter( nType: short. Category : String ) - sets/retrieves filter setting 
nType argument defines type of filter 0 - include, 1 - exclude 
Category argument defines filter category: 

"index", "favorite", "market", "group", "sector", "index", "watchlist" 


Analysis 
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AnalysisDoc 

AnalysisDoc is a new object introduced in version 5.50. It ailows to access New Anaiysis 
project documents (apx extension) and perform muitithreaded 

scans/explorations/backtests/optimizations in New Analysis window in asynchronous way. 
Asynchronous means that Run() method only starts the process and returns immediatelly. To 
wait for completion you must check IsBusy flag periodically (such as every second) in your 
own code. 

Properties: 

♦ Property IsBusy As Boolean [r] 

Methods: 

♦ Sub CloseO 

♦ Function Export(ByVal pszFileName As String) As Long 

♦ Function Run(ByVal Action As Long) As Long 

Description: 

AnalysisDoc object provides programmatic control of New Analysis document/window. 

IsBusy property allows to check whenever Analysis window is busy doing analysis. You must 
check this flag periodically if you want to wait for completion. Take care NOT to call this too 
often as it will decrease performance. For best results check it every one second. Also you 
need to check this flag if you are not sure whenever Analysis window is busy before trying to 
call ExportO or Run(), otherwise these calls would fail if analysis is in progress. 

Close( ) method closes Analysis document/window. If there is any operation in progress it will 
be terminated. To prevent premature termination, check IsBusy property. 

Export( pszFileName ) method allows to export analysis result list to either .HTML or .CSV 
file. Returns 1 on success (successful! export) or 0 on failure (for example if analysis window 
is busy) 

Run( Action ) method allows to run asynchronously scan/explorations/backtest/optimizations. 
Action parameter can be one of the following values: 

0 : Scan 

1 : Exploration 

2 : Portfolio Backtest 

3 : Individual Backtest 

4 : Portfolio Optimization 

5 : Individual Optimization (supported starting from v5.69) 

6 : Walk Forward Test 

It is important to understand that Run method just starts the process and returns 
immediatelly. It does NOT wait for completion. 

To wait for completion you need to query IsBusy flag periodically (such as every one second). 

Run() returns 1 on success (successfully starting process) or 0 on failure (for example if 
analysis window is busy) 


AnaiysisDoc 
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The procedure to run automated backtest involves opening previously saved Analysis project 
(it includes all settings that are necessary to perform any action), call Run() and wait for 
completion. 

Since currently you can have multiple analysis projects running, there is an AnalysisDocs 
collection that represents all open Analysis documents and allow you to open previously 
saved files (that contain formula, settings and everything needed to run). 

New AnalysisDoc object does not allow you to read/write settings for the purpose - you are 
not supposed to manipulate Ul while new Analysis window is running. Correct way of using 
New Analysis window is to open existing project file and run. If you want to modify the 
settings, you should write/modify existing project file. The analysis project file (.apx extension) 
is human-readable self-explanatory XML-format file that can be written/edited/modified from 
any language / any text editor. 

The following JScript example 

a) opens analysis project from C:\Analysis1 .apx file 

b) starts backtest (asynchronously) 

c) waits for completion 

d) exports results 

e) closes analysis document 

AB = new ActiveXObject( "Broker.Application" ); // creates AmiBroker 

object 

try 

{ 

NewA = AB.AnalysisDocs.Open( "C:Wanalysisl.apx" ); // opens 

previously saved analysis project file 

// NewA represents the instance of New Analysis document/window 

if ( NewA ) 

{ 

NewA.Run( 2 ); // start backtest asynchronously 

while ( NewA.IsBusy ) WScript.Sleep( 500 ); // check IsBusy 
every 0.5 second 

NewA.Export( "test.html" ); // export result list to HTML 

file 


WScript.echo( "Completed" ); 

NewA.Close 0; // close new Analysis 

} 

} 

catch ( err ) 

{ 

WScript.echo( "Exception; " + err.message ); // display error 
that may occur 

} 


AnalysisDoc 
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AnalysisDocs 

AnalysisDocs is a new object introduced in version 5.50. It is a coilection of AnalysisDoc 
objects. Aiiows to Add new Analysis, Open existing analysis project, and iterate thru analysis 
objects. 

Methods: 

♦ Function Add() As Object 

♦ Sub CloseO 

♦ Function Open(ByVal FileName As String) As Object 

Properties: 

♦ ltem(ByVal Index As Long) As Object [r/o] [default] 

♦ Count As Long 

♦ Application As Object 

♦ Parent As Object 

Description: 

AnalysisDocs is a collection of AnalysisDoc objects. 

Add method creates new Analysis document/window. The method returns AnalysisDoc 
object. 

Close method closes all open Analysis documents/windows. If any analysis project is running 
it will be terminated immediatelly 

Open method allows to open existing Analysis project file (.apx). The method returns 

AnalysisDoc object. 

Item property allows to access Index-th element of collection. The property returns 

AnalysisDoc object. 

Count property gives number of open analysis documents. 

Both Application and Parent properties point to Broker.Application object 
For example usage, see AnalysisDoc object description. 

Application 

Methods: 

♦ Function lmport(ByVal Type As Integer, ByVal FileName As String, [ByVal 
DefFileName As Variant]) As Long 

♦ Function LoadDatabase(ByVal Path As String) As Boolean 

♦ Function LoadLayout(ByVal pszFileName As String) As Boolean 

♦ Function Log(ByVal Action As Integer) As Long 

♦ Sub Quito 

♦ Sub RefreshAIIQ 
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♦ Sub SaveDatabaseO 

♦ Function SaveLayout(ByVal pszFileName As String) As Booiean 

Properties: 

♦ ActiveDocument As Object 

♦ Stocks As Object 

♦ Version As String 

♦ Documents As Object 

♦ Markets As Object 

♦ DatabasePath As String 

♦ Anaiysis As Object 

♦ Commentary As Object 

♦ ActiveWindow As Object 

♦ Visibie As Integer 
Description: 

Appiication object is main OLE automation object for AmiBroker. You have to create it prior to 
accesing any other objects. To create Appiication object use the foliowing code: 

JScript: 

AB = new ActiveXObject("Broker.Application"); 

VB/VBScript: 

AB = CreateObject("Broker.Application") 

AFL: 

AB = CreateObject("Broker.Application"); 

Window 

Methods: 

♦ Sub ActivateO 

♦ Sub CioseO 

♦ Function Exportimage(ByVal FiieName As String, [ByVal Width As Variant], [ByVal 
Height As Variant], [ByVal Depth As Variant]) As Boolean 

♦ Function LoadTempiate(ByVal ipszFiieName As String) As Boolean 

♦ Function SaveTempiate(ByVal ipszFiieName As String) As Boolean 

♦ Function ZoomToRange(ByVal From As Variant, ByVal To As Variant) As Boolean 
Properties: 

♦ SeiectedTab As Long 

♦ Document As Object 
Description: 

Window object provides programmatic control over charting window. 
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Windows 

Methods: 

♦ Function Add() As Object 
Properties: 

♦ ltem(ByVal Index As Long) As Object [r/o] [default] 

♦ Count As Long 
Description: 

Windows is a coliection of Window objects. 

Commentary 

Methods: 

♦ Sub ApplyO 

♦ Sub CloseO 

♦ Function LoadFormula(ByVai pszFileName As String) As Booiean 

♦ Function Save(ByVai pszFileName As String) As Booiean 

♦ Function SaveFormula(ByVai pszFileName As String) As Booiean 

Description: 

Commentary object gives programmatic controi over guru commentary window. 

Document 

Methods: 

♦ Sub ActivateO 

♦ Sub CloseO 

♦ Sub ShowMessage(ByVai Text As String) 

Properties: 

♦ Application As Object 

♦ Parent As Object 

♦ Name As String 

♦ ActiveWindow As Object 

♦ Windows As Object 
Description: 

Document object represents active document (of 'chart' type). In document-view architecture 
each document can have muitipie windows (views) connected. Name property defines 
currentiy seiected symboi for the document. 

Documents 
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Methods: 

♦ Function Add() As Object 

♦ Sub CloseO 

♦ Function Open(ByVal Ticker As String) As Object 

Properties: 

♦ item(ByVal index As Long) As Object [r/o] [defauit] 

♦ Count As Long 

♦ Appiication As Object 

♦ Parent As Object 

Description: 

Documents is a coiiection of document objects. 

Market 

Properties: 

♦ Name As String 

♦ ADQuotations As Object 
Description: 

Market represents market category and its related data (i.e. per-market advance/decline 
information) 

Markets 

Properties: 

♦ item(ByVai index As integer) As Object [r/o] [defauit] 

♦ Count As Integer 
Description: 

Markets is a collection of Market objects 

Quotation 

Properties: 

♦ Date As Date 

♦ Ciose As Single 

♦ Open As Single 

♦ High As Single 

♦ Low As Single 

♦ Voiume As Single 

♦ Openint As Single 
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Description: 

Quotation class represents one bar of price data 

Quotations 

Methods: 

♦ Function Add(ByVal Date As Date) As Object 

♦ Function Remove(ByVal item As Variant) As Boolean 

♦ Function Retrieve(ByVal Count As Long, ByRef Date As Variant, ByRef Open As 
Variant, ByRef High As Variant, ByRef Low As Variant, ByRef Ciose As Variant, 
ByRef Voiume As Variant, ByRef Openint As Variant) As Long 

Properties: 

♦ item(ByVai item As Variant) As Object [r/o] [defauit] 

♦ Count As Long 
Description: 

Quotations is a collection of Quotation objects. It represents all quotations available for given 
symbol. Quotations collection is available as a property of Stock object. 


Stock 


Properties: 

♦ Ticker As String 

♦ Quotations As Object 

♦ FuiiName As String 

♦ index As Boolean 

♦ Favourite As Boolean 

♦ Continuous As Boolean 

♦ MarketiD As Long 

♦ GroupiD As Long 

♦ Beta As Single 

♦ SharesOut As Single 

♦ BookVaiuePerShare As Single 

♦ SharesFioat As Single 

♦ Address As String 

♦ WebiD As String 

♦ Aiias As String 

♦ isDirty As Boolean 

♦ industryiD As Long 

♦ WatchListBits As Long 

♦ DataSource As Long 

♦ DataLocaiMode As Long 

♦ PointVaiue As Single 

♦ MarginDeposit As Single 

♦ RoundLotSize As Single 

♦ TickSize As Single 

♦ WatchListBits2 As Long 
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♦ Currency As String 

♦ LastSplitFactor As String 

♦ LastSplitDate As Date 

♦ DividendPerShare As Singie 

♦ DividendPayDate As Date 

♦ ExDividendDate As Date 

♦ PEGRatio As Single 

♦ ProfitMargin As Single 

♦ OperatingMargin As Single 

♦ OneYearTargetPrice As Single 

♦ ReturnOnAssets As Single 

♦ ReturnOnEquity As Single 

♦ QtrlyRevenueGrowth As Single 

♦ GrossProfitPerShare As Single 

♦ SalesPerShare As Single 

♦ EBlTDAPerShare As Single 

♦ QtrlyEarningsGrowth As Single 

♦ InsiderHoldPercent As Single 

♦ InstitutionHoldPercent As Single 

♦ SharesShort As Single 

♦ SharesShortPrevMonth As Single 

♦ ForwardDividendPerShare As Single 

♦ ForwardEPS As Single 

♦ EPS As Single 

♦ EPSEstCurrentYear As Single 

♦ EPSEstNextYear As Single 

♦ EPSEstNextQuarter As Single 

♦ OperatingCashFlow As Single 

♦ LeveredFreeCashFlow As Single 
Description: 

Stock class represents single symbol data. For historical reasons the name of the object is 
Stock, but it can hold any kind of instrument (including futures, forex, etc). 

Stocks 

Methods: 

♦ Function Add(ByVal Ticker As String) As Object 

♦ Function GetTickerList(ByVal nType As Long) As String 

♦ Function Remove(ByVal item As Variant) As Boolean 

Properties: 

♦ item(ByVal item As Variant) As Object [r/o] [default] 

♦ Count As Long 
Description: 

Stocks is a collection of Stock objects. It is available as a property of Application object. 
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Notes: 

Stock.WatchListBits (long) - each bit 0..31 represents assignment to one of 32 watch lists to 
add a stock to nth watch list write (JScript example): 

Stock.WatchListBits |= 1 « nth; 

Stock.WatchListBits2 (long) - each bit 0..31 represents assignment to one of watch lists 
numbered from 32..63 to add a stock to nth watch list write (JScript example): 
Stock.WatchListBits2 |= 1 « ( nth - 32 ); 

Stock.DataSource ( 0 - default, 1 - local only ) 

Stock.DataLocalMode ( 0 - default, 1 - store locally, 2 - don't store locally) 

Practical Examples: 

Example 1: Running simple backtest 

AB = new ActiveXObject( "Broker.Application" ); // creates AmiBroker object 


try 

{ 

NewA = AB.AnalysisDocs.Open( "C:Wanalysisl.apx" ); // opens previously saved 

analysis project file 

// NewA represents the instance of New Analysis document/window 

if ( NewA ) 

{ 

NewA.Run( 2 ); // start backtest asynchronously 

while ( NewA.IsBusy ) WScript.Sleep( 500 ); // check IsBusy every 0.5 

second 

NewA.Export! "test.html" ); // export result list to HTML file 
WScript.echo( "Completed" ); 

NewA.Close 0; // close new Analysis 

} 

} 

catch ( err ) 

{ 

WScript.echo( "Exception; " + err.message ); // display error that may occur 

} 


Example 2: Execute commentary 

AB = new ActiveXObject( "Broker.Application" ); 

AB.Commentary.LoadFormula( "C:\\Program FilesX\AmiBroker\\AFL\\MACD_c.af1" ); 
AB.Commentary.Apply() ; 
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AB . Conunentary . Save ("Test.txt") ; 

AB.Commentary.SaveFormula( "MACDTest. af1 " ); 
//AB.Commentary.Close() ; 


Practicai Exampies: 
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AmiQuote's OLE Automation Object Model 
Index of objects 

• Document 

AmiQuote is SDI (single document) application therefore there is only one class - Document - creatable using 
the following code: 

JScript: 

AB = new ActiveXObject("AmiQuote.Document"); 

VB/VBScript: 

AB = CreateObject("AmiQuote. Document") 

AFL: 

AB = CreateObject("AmiQuote.Document"); 


Document 

Methods: 

♦ Function AddSymbols(ByVal pszSymbols As String) As Boolean 

♦ Function Download() As Boolean 

♦ Function GetSymbolsFromAmiBroker() As Boolean 

♦ Function ImportQ As Boolean 

♦ Sub MoveWindow(ByVal x As Long, ByVal y As Long, ByVal width As Long, ByVal 
height As Long) 

♦ Function Open(ByVal pszFiieName As String) As Boolean 

♦ Function RemoveAiiSymbois() As Boolean 

♦ Function RemoveSymbois(ByVal pszSymbois As String) As Boolean 

♦ Function Save() As Boolean 

♦ Function SaveAs(ByVal pszFiieName As String) As Boolean 

Properties: 

♦ DownioadinProgress As Boolean 

♦ importinProgress As Boolean 

♦ Source As Long 

♦ From As Date 

♦ To As Date 

♦ Autoimport As Boolean 

♦ AiiSessions As Boolean 

♦ intervai As Long 

♦ RunEvery As Long 

♦ DestinationFoider As String 
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Introduction 
Basic tools 
Indicators 

Introduction 

Technical analysis is the examination of past price movements to forecast future price movements. Technical 
analysts are sometimes referred to as chartists because they rely almost exclusively on charts for their 
analysis. 

Technical analysis is applicable to stocks, indices, commodities, futures, currencies or any tradable instrument 
where the price is influenced by the forces of supply and demand. Price refers to any combination of the open, 
high, low or close for a given security over a specific timeframe. The time frame can be based on intraday, 
daily, weekly or monthly price data and last a few hours or many years. In addition, some technical analysts 
include volume or open interest figures with their study of price action. 

AmiBroker provides a comprehensive set of technical analysis tools that will be presented in this chapter. 
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Basic tools 

AmiBroker has following basic technical analysis tools: 

• Price charts 

• Trend lines 

• Moving averages 

• Fibonacci retracement 

• Fibonacci time zones 

• Regression channels 

• Bollinger bands 


Basic tools 
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Price charts 

AmiBroker can display the prices using: 

• line chart 

this mode is used when current symbol uses price fixing and only close price is available 

• traditional bar chart 

this mode is used when continuous trading is enabled, but open price is not available (or equals to 
close price) 

• Japanese Candlesticks 

this mode is used when continuous trading is enabled with open/close/high/low data 

A line chart is the simplest type of chart. One price (close) is plotted for each time period. A single line 
connects each of these price points. The main strength of this chart type is simplicity. 

Bar charts are one of the most popular types of charts used in technical analysis. For each trading day a 
vertical line is plotted. The top of the vertical line indicates the highest price a security traded at during the 
day, and the bottom represents the lowest price. The closing price is displayed by the mark on the right side of 
the bar and opening prices are shown on the left side of the bar. 

Developed by the Japanese in the 1600's, candlestick charts are merely bar charts that extenuate the 
relationship between open, high, low and closing prices. Each candlestick represents one period of data 
(day-week) and consists of an upper shadow, lower shadow and the body. The upper shadow is the highest 
price that the stock traded at for the period while the lower shadow represents the lowest price. The 
candlestick body is black when the close is less than the open or white when the close is greater than the 
open. The top of the body is the opening price if the candle is black and the candle is referred to as a long 
black candle. If the candle is white, the top of the body is the closing price and the candle is referred to as a 
long white candle. 

Steven Nison's articles that explain Candlestick charting appeared in the December, 1989 and April, 1990 
issues of Futures Magazine. The definitive book on the subject is Japanese Candlestick Charting Techniques 
also by Steve Nison. 

There are many different candlestick formations. Some are considered to be minor formations while others 
are major. Candlestick charts dramatically illustrate supply/demand concepts defined by classical technical 
analysis theories. 

Major Candlestick Chart Formations: 

Gravestone Doji: A doji (open and close are the same) and the high is significantly higher than the open, high 
and closing prices. This formation typically occurs at the bottom of a trend and signals a bullish reversal. 

Dragon-fly Doji: A doji (open and close are the same) and the low is significantly lower than the open, high 
and closing prices. This formation typically occurs at the top of a trend and signals a bearish reversal. 

Abandoned Baby Doji: A doji, which occurs at the bottom of a chart formation with gaps on both sides of the 
doji. 

Harami Cross: This formation signals a market top. It consists of a harami, which is a long black line 
candlestick which precedes and engulfs a doji with no body. 
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Engulfing Pattern: A two-candle bullish formation consisting of a small long black line engulfed by the 
second candle, a long white line. 

Evening Star: A bearish pattern usually occurring at a top. The formation consists of three candles. The first 
is a long white line followed by a star and then a long black line. The star can be either black or white. 

Dark Cloud Cover: A two candle formation whereby the first candle is a long white line and the second 
candle is a long black line whose body is below the center of the first candle. This is a bearish formation. 


Price charts 


474 



AmiBroker 6.00 User's Guide 


Technical analysis guide 


Trend lines 

Technical analysis is built on the assumption that prices trend. Trendlines are an important tool in technical 
analysis for both trend identification and confirmation. A trendline is a straight line that connects two or more 
price points and then extends into the future to act as a line of support or resistance. Many of the principles 
applicable to support and resistance levels can be applied to trendlines as well. 

Up Trendline 

An up trendline has a positive slope and is formed by connecting two of more low points. The second low 
must be higher than the first for the line to have a positive slope. Up trendlines act as support and indicate that 
net-demand (demand less supply) is increasing even as the price rises. A rising price combined with 
increasing demand is very bullish and shows a strong determination on the part of the buyers. As long as 
prices remain above the trendline, the uptrend is considered solid and intact. A break below the up trendline 
indicates that net-demand has weakened and a change in trend could be imminent. 

Down Trendline 

A down trendline has a negative slope and is formed by connecting two or more high points. The second high 
must be lower than the first for the line to have a negative slope. Down trendlines act as resistance and 
indicate that net-supply (supply less demand) is increasing even as the price declines. A declining price 
combined with increasing supply is very bearish and shows the strong resolve of the sellers. As long as prices 
remain below the down trendline, the downtrend is considered solid and intact. A break above the down 
trendline indicates that net-supply is decreasing and a change of trend could be imminent. 

Scale Settings 

High points and low points appear to line up better for trendlines when prices are displayed using a semi-log 
scale. This is especially true when long-term trendlines are being drawn or there has been a large change in 
price. AmiBroker allows to set the scale as arithmetic or logarithmic (semi-log). An arithmetic scale displays 
incremental values (5,10,15,20,25,30) evenly as they move up the y-axis. A $10 movement in price will look 
the same from $10 to $20 or from $100 to $110. A semi-log scale displays incremental values in percentage 
terms as they move up the y-axis. A move from $10 to $20 is a 100% gain and would appear to be a much 
larger than a move from $100 to $110, which is only a 10% gain. 

Please remember however that straight line in the log chart is no longer straight in the linear scale, so trend 
lines drawn in one scale may look strange in the other scale. 

Validation 

It takes two or more points to draw a trendline. The more points used to draw the trendline, the more validity 
attached to the support or resistance level represented by the trendline. It can sometimes be difficult to find 
more than 2 points from which to construct a trendline. Even though trendlines are an important aspect of 
technical analysis, it is not always possible to draw trendlines on every price chart. Sometimes the lows or 
highs just don't match up and it is best not to force the issue. The general rule in technical analysis is that it 
takes two points to draw a trendline and the third point confirms the validity. 
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Moving averages 

The moving average is one of the most usefui, objective and oidest anaiyticai toois around. Some patterns 
and indicators can be somewhat subjective, where anaiysts may disagree on if the pattern is truiy forming or if 
there is a deviation that is might be an iiiusion. The moving average is more of a cut-and-dry approach to 
anaiyzing stock charts and predicting performance, and it is one of the few that doesn't require a genius 
inteiiigence to interpret.. 

Moving average is an indicator that shows the average vaiue of a security's price over a period of time. 

To find the 50 day Simpie Moving Average you wouid add up the ciosing prices (but not aiways more iater) 
from the past 50 days and divide them by 50. And because prices are constantiy changing it means the 
moving average wiii move as weii. 

Exponentiai Moving Average (EMA) - is caicuiated by appiying a percentage of today's ciosing price to 
yesterday's moving average vaiue. Use an exponentiai moving average to piace more weight on recent 
prices. As expected, each new price has a greater impact on the EMA than it has on the SMA. And, each new 
price changes the moving average oniy once, not twice. 

The most commoniy used moving averages are the 15, 20, 30, 45, 50, 100, and 200 day averages. Each 
moving average provides a different interpretation on what the stock price wiii do. There reaiiy isn't just one 
"right" time frame. Moving averages with different time spans each teii a different story. The shorter the time 
span, the more sensitive the moving average wiii be to price changes. The ionger the time span, the iess 
sensitive or the more smoothed the moving average wiii be. Moving averages are used to emphasize the 
direction of a trend and smooth out price and voiume fiuctuations or "noise" that can confuse interpretation. 

Different investors use moving averages for different reasons. Whiie some use it as their primary anaiytic tooi 
others simpiy use the moving average as confidence buiider to back their investment decisions. Here are two 
other strategies that peopie use moving averages for: 

Filters 

Fiitering is used to increase your confidence about an indicator. There are no set ruies or things to iook out for 
when fiitering, just whatever makes you confident enough to invest your money. For exampie you might want 
to wait untii a security crosses through its moving average and is at ieast 10% above the average to make 
sure that it is a true crossover. Remember, setting the percentiie too high couid resuit in "missing the boat" 
and buying the stock at its peak. 

Another fiiter is to wait a day or two after the security crosses over, this can be used to make sure that the rise 
in the security isn't a fiuke or unsustained. Again, the downside is if you wait too iong then you couid end up 
missing some big profits. 

Crossovers 

Using Crossovers isn't quite as easy as fiitering. There are severai different types of crossover's, but aii of 
them invoive two or more moving averages. In a doubie crossover you are iooking for a situation where the 
shortest MA crosses through the ionger one. This is aimost aiways considered to be a buying signai since the 
ionger average is somewhat of a support ievei for the stock price. 

For extra insurance you can use a tripie crossover, whereby the shortest moving average must pass through 
the two higher ones. This is considered to be an even stronger buying indicator. 
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Regression channels 

Linear regression may sound intimidating, but the mathematicai concept is a simpie one. Aii this technique 
does is fit a straight iine through a finite number of data points by minimizing the sum of the squared verticai 
distance between the iine and each of the points. In our context, this means that if time is represented by days 
on the horizontai axis and the closing price 

on those days is plotted as dots on the vertical axis (a normal closing price chart), then we try to fit a straight 
line through those closing-price dots such that the total sum of the squared vertical distance between each 
closing price and the line are minimized. This would then be our best-fit line. 

Raff regression channel Raff Regression Channels show the range prices can be expected to deviate from a 
Linear Regression trend line. Developed by Gilbert Raff, the regression channel is a line study the plots 
directly on the price chart. The Regression Channel provides a precise quantitative way to define a price trend 
and its boundaries. The Regression Channel is constructed by plotting two parallel, equidistant lines above 
and below a Linear Regression trend line. 

The distance between the channel lines to the regression line is the greatest distance that any one high or low 
price is from the regression line. 

Raff Regression Channels contain price movement, with the bottom channel line providing support and the 
top channel line providing resistance. Prices may extend outside of the channel for a short period of time. 
However, if prices remain outside the channel for a long period of time, a reversal in trend may be imminent. 
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Fibonacci Retracement 

Fibonacci Retracements/Extensions are dispiayed by first drawing a trendiine between two extreme points. 
After seiecting Fibonacci Retracement tooi from Draw tooibar, a series of up to nine horizontai iines wiii be 
drawn at the Fibonacci ieveis of 0.0%, 23.6%, 38.2%, 50.0%, 61.8%, 100%, 161.8%, 261.8% and 423.6%. 
After a significant move (up or down), prices wiii often rebound and retrace a significant portion of the originai 
move. As the price retraces, support and resistance ieveis wiii often occur near the Fibonacci Retracement 
ieveis. 

Fibonacci retracement/extension tooi works in 4 different modes depending on the direction of trend iine 
drawn: 


• NE - gives (oid-styie) retracement in up trend 

• SE - gives retracement in down trend 

• NW - gives extension in up trend 

• SW - gives extension in down trend 

A controiiing trend iine drawn with dotted styie can be used to deiete Fibonacci retracement study at once 
using right mouse button menu. 
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Fibonacci Time Zones 

The Fibonacci Time Zones study consists of verticai iines at the Fibonacci intervais of 1,2, 3, 5, 8, 13, 21,34, 
etc. The interpretation of Fibonacci Time Zones invoives iooking for significant changes in price near the 
verticai iines. 
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Bollinger bands 

Bollinger Bands are envelopes which surround the price bars on a chart. Bollinger Bands are plotted two 
standard deviations away from a simple short-term moving average. This is the primary difference between 
Bollinger Bands and envelopes. Envelopes are plotted a fixed percentage above and below a moving 
average. Because standard deviation is a measure of volatility, the Bollinger Bands adjust themselves to the 
market conditions. They widen during volatile market periods and contract during less volatile periods. 
Bollinger Bands become moving standard deviation bands. Bollinger Bands are displayed with a third line. 

This is the simple (short-term) moving average line. The time period for this moving average can vary. The 
default for short-term moving average in AmiBroker is 15 days. 

An important thing to keep in mind is that Bollinger Bands do not generate buy and sell signals alone. They 
should be used with another indicator. RSI, for example, is quite good choice as a companion for Bollinger 
bands. When price touches one of the bands, it could indicate one of two things. It could indicate a 
continuation of the trend; or it could indicate a reaction the other way. So Bollinger Bands used by themselves 
do not provide all of what technicians need to know. Then RSI, which is an excellent indicator with respect to 
overbought and oversold conditions, comes with help. Generally, when price touches the upper Bollinger 
Band, and RSI is below 70, we have an indication that the trend will continue. Conversely, when price touches 
the lower Bollinger Band, and RSI is above 30, we have an indication that the trend should continue. If we run 
into a situation where price touches the upper Bollinger Band and RSI is above 70 (possibly approaching 80) 
we have an indication that the trend may reverse itself and move downward. On the other hand, if price 
touches the lower Bollinger Band and RSI is below 30 (possibly approaching 20) we have an indication that 
the trend may reverse itself and move upward. Avoid the trap of using several different indicators all working 
off the same input data. If you're using RSI with the Bollinger Bands, don't use MACD too. They both rely on 
the same inputs. You might consider using On Balance Volume, or Money Flow. RSI, On Balance Volume, 
and Money Flow, rely on different inputs. 
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Indicators 

What is an indicator? 

An indicator is a mathematicai caicuiation that can be appiied to a security's price and/or voiume fieids. The 
result is a value that is used to anticipate future changes in prices. 

AmiBroker has following indicators built-in: 

• ROC 

• RSI 

• MACD 

• CCI 

• OBV 

• NVI 

• MFI 

• Accumulation/Distribution 

• TRIX 

• Chaikin 

• Relative Strength 

• Ultimate Oscillator 

• Stochastic 

• TRIM (Arms Index) 

• AD-Line (Advance/Decline line) 

• Volume At Price histogram (Volume Profile) 

• Relative Performance 
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Accumulation/Distribution 


Accumulation/Distribution is a momentum indicator which takes into account changes in price and voiume 
together. The idea is that a change in price coupied with an increase in voiume may heip to confirm market 
momentum in the direction of the price move. 

Note the simiiarity of this formuia to that of the stochastic; this is basicaiiy a stochastic muitipiied by voiume. 
This means that if the security doses to its high, the voiume muitipiier wiii greater than if the security cioses 
nearer to its iow. 


If the Accumuiation/Distribution indicator is moving up the buyers are driving the price move and the security 
is being accumuiated. A decreasing A/D vaiue impiies that the seiiers are driving the market and the security 
is being distributed. If divergence occurs between the Accumuiation/Distribution indicator and the price of the 
security a change in price direction is probabie. 

The Accumuiation/Distribution Line formuia is as foiiows: 


(CLOSE -LOW)- {HIGH - CLOSE) 
HIGH-LOW 


VOLUME 


+ l 


Where / is yesterday's Accumuiation/Distribution vaiue. 
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Advance-Decline line (AD-Line) 

Line measuring advances and deciines that reflects market breadth. In its simplest form ADLine is a 
summation over time of the net daily difference between the number of advancing issues and the number of 
declining issues. AmiBroker uses slightly improved formula which takes into account also number of 
unchanged issues. The exact AFL formula for AmiBroker's ADLine is: 

Difference = ( AdvIssuesO - DecIssuesO )/ ( UncIssuesO + 1 ); 

DiffSqrt = IIF( Difference > 0, sqrt( Difference ), - sqrt( - Difference ) ); 
ADLine = Cum( DiffSqrt ); 

This is a classical indicator which tends to give a good reading of the overall strength of the market. A break in 
the A/D line usually proceeds a break in prices. Look for non-confirmation and divergence. 

See also AFL Function reference: AFL Function: adline() 
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ADX / Directional Movement Index 

The ADX Indicator, otherwise known as Directionai Movement Index. 

The ADX is a trend foiiowing system. The average directionai movement index, or ADX, determines the 
market trend. When used with the up and down directionai indicator vaiues, +DI and -Dl, the ADX is an exact 
trading system. The standard interpretation for using the ADX (biue iine) is to estabiish a iong position 
whenever the +DI (green iine) crosses above the -Dl (red line). You reverse that position, liquidate the long 
position and establish a short position, when the -Dl crosses above the -i-DI. In addition to the crossover rules, 
you must also follow the extreme point rule. When a crossover occurs, use the extreme price as the reverse 
point. For a short position, use the high made during the trading interval of the crossover. Conversely, reverse 
a long position using the low made during the trading interval of the crossover. You maintain the reverse point, 
the high or low, as your market entry or exit price even if the -i-DI and the -Dl remain crossed for several 
trading intervals. This is supposed to keep you from getting whipsawed in the market. For some traders, the 
most significant use of the ADX is the turning point concept. First, the ADX must be above both Dl lines. 

When the ADX turns lower, the market often reverses the current trend. The ADX serves as a warning for a 
market about to change direction. The main exception to this rule is a strong bull market during a blow-off 
stage. The ADX turns lower only to turn higher a few days later. According to the developer of the DMI, you 
should stop using any trend following system when the ADX is below both Dl lines. The market is in a choppy 
sidewise range with no discernible trend. If you need further explanation, please refer to the author's original 
work. The book titled New Concepts in Technical Trading Systems by J. Welles Wilder, Jr. explains this 
indicator and several others. 
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CCI - Commodity Channel Index 

A price momentum indicator deveioped by Donaid R. Lambert - it measures price excursions from the mean 
price as a statisticai variation. The indicator works quite weii with commodities, stocks and mutuai funds. It 
keeps trades neutrai in a sideways moving market, and heips get in the market when a breakout occurs. 

A description of the CCI formula is as follows: 

First, Calculate each periods mean. This is the high, plus the low, plus the close, divided by 3. 

Second, calculate the n period simple moving average of these means. 

Third, from each periods mean price, subtract the n period simple moving average of mean prices. 

Fourth, Compute the mean deviation. This is the differences between each period's mean price and the n 
period simple moving average of those mean prices. 

Fifth, Multiply the mean deviation by .015. 

Sixth, the mean price, which we calculated in step three, is divided by .015 times the mean deviations from 
step 5. 

Ordinarily, CCI ranges in value from +100 to -100. The rules are to buy and go long when CCI crosses above 
+100 and close the long when CCI falls back below +100. Conversely, sell short when CCI crosses below 
-100 and close the short when CCI crosses back above -100. 
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Chaikin Osciiiator 

Developed by Marc Chaikin back in the early 1970's when opening prices were eliminated from many 
newspaper listings making it more difficult to calculate William's OBV. Chaikin substituted the average price 
[(HIGH+LOW)/2] for William's opening price and created an oscillator using 10-period and 3-period 
exponential moving averages of the resulting Accumulation/Distribution Line. 

The basic premise of the Accumulation/Distribution Line is that the degree of buying or selling pressure can 
be determined by the location of the close, relative to the high and low for the corresponding period. There is 
buying pressure when a stock closes in the upper half of a period's range and there is selling pressure when a 
stock closes in the lower half of the period's trading range. 

Bullish Signals 

There are two bullish signals that can be generated from the Chaikin Oscillator: positive divergences and 
centerline crossovers. Because the Chaikin Oscillator is an indicator of an indicator, it is prudent to look for 
confirmation of a positive divergence, by a bullish moving average crossover for example, before counting this 
as a bullish signal. 

Bearish Signals 

In direct contrast to the bullish signals, there are two bearish signals that can be generated from the Chaikin 
Oscillator: a negative divergence and a bearish centerline crossover. Allow a negative divergence to be 
confirmed by a bearish centerline crossover, before a bullish signal is rendered. 

The Chaikin Oscillator is good for adding momentum to the Accumulation/Distribution Line, but can 
sometimes add a little too much momentum and be difficult to interpret. The moving averages are both 
relatively short and will therefore be more sensitive to changes in the Accumulation/Distribution Line. 
Sensitivity is important, but one must also be able to interpret the indicator. 
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MACD - Moving Average Convergence/Divergence 

This indicator uses three exponentiai moving averages, a short or fast average, a iong or siow average and an 
exponentiai average of their difference, the iast being used as a signai or trigger iine. To fuiiy understand the 
basics of MACD you must first understand simpie moving averages. The Moving Average 
Convergence/Divergence indicator measures the intensity of pubiic sentiment and is considered by Geraid 
Appei, its deveioper, to be a very good indicator signaiing market entry points after a sharp deciine. This 
indicator reveai overbought and oversoid conditions and generates signais that predict trend or price 
reversais. it provides a sensitive measurement of the intensity of pubiic sentiment and can be appiied to the 
stock market, to individuai stocks or to mutuai funds, in some instances, it can provide advance warning of 
reversais aiiowing you to buy into weakness and seii into strength. 

The Moving Average Convergence/Divergence indicator (MACD) is caicuiated by subtracting the vaiue of 
26-day exponentiai moving average from a 12-day exponentiai moving average. A 9-day exponentiai moving 
average (the "signai iine") is automaticaiiy dispiayed on top of the MACD indicator iine. 

The basic MACD trading ruie is to seii when the MACD faiis beiow its 9-day signai iine. Simiiariy, a buy signai 
occurs when the MACD rises above its signai iine. 
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Money Flow Index 

The Money Flow Index (MFI) attempts to measure the strength of money flowing in and out of a security. It is 
closely related to the Relative Strength Index (RSI). The difference between the RSI and Money Flow is that 
where RSI only looks at prices, the Money Flow Index also takes volume into account. 

Calculating Money Flow is a bit more difficult than the RSI. 

First we need the average price for the day thenwe need the Money Flow: 

MoneyFiow = Volume x Average Price 

Now, to calculate the money flow ratio you need to separate the money flows for a period into positive and 
negative. If the price was up in a particular day this is considered to be "Positive Money Flow". If the price 
closed down it is considered to be "Negative Money Flow". 

Positive MoneyFlov) 

MoneyRatio = —-—-—— 

mgative MoneyFiow 

It is the Money Flow Ratio which is used to calculate the Money Flow Index. 


100 + MoneyRatio 

The Money Flow ranges from 0 to 100. Just like the RSI, a stock is considered overbought in the 70- 80 range 
and oversold in the 20-30 range. 

The shorter number of days you use, the more volatile the Money Flow is. The default is to use a 14 day 
average. 

The interpretation of the Money Flow Index is as follows: 

• Look for divergence/failure swings between the indicator and the price action. If the price trends 
higher (lower) and the MFI trends lower (higher), then a reversal may be imminent. 

• Look for market tops to occur when the MFI is above a specific level (e.g., 80). Look for market 
bottoms to occur when the MFI is below a specific level (e.g., 20). 
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Negative Volume Index 

This indicator makes a very important assumption, it assumes that the unsophisticated investor foiiows market 
trends thus pushing up voiume as they jump in on a rising security price. On the other hand, informed buying 
and seiiing by those "in the know" occurs on quieter periods refiected by negative voiume changes on days of 
deciining voiume. This is an exceiient buii market trend predictor. This index simpiy measures the trend of 
prices during periods when the voiume is deciining. 

The price index is oniy adjusted on those days during which the voiume has decreased from the previous day. 
if the voiume did not change or was positive, the indicator remains unchanged, if the index rises, it means 
simpiy that the price of the security has gone up on a day that the voiume has dropped. A drop in the index 
indicates that the price of the security has gone down whiie the voiume deciined. (The change in the index is 
caicuiated as a percentage change in the price). 

This indicator can be compared to its ionger period averages to refiect the movement of smart money, if, for 
exampie current index readings are above a six-month average, it can very weii indicate an up trend for the 
market or the security. 
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OBV - On Balance Volume 

OBV was created by Joe Granville, the father of OBV analysis. This is a running total of volume that relates 
price changes and volume and shows accumulation and distribution action. 

The classic OBV is calculated by adding todays total volume to a cumulative total when price closes higher 
than yesterdays close and subtracting todays total volume from the cumulative when the price closes lower 
than yesterdays close. If price remains the same, then the OBV is not changed. The actual amount of the 
price change is irrelevant and only the direction of change is significant for these calculations. 

This indicator defines trends by showing underlying strength of price movements over time. A solid price trend 
is assumed to be accompanied with a stronger volume movement in the same direction. OBV analysis 
assumes that volume trends lead price trends and that OBV changes generally precede price changes. Look 
for divergence or non-confirmation between price and volume movements. A stock that is trending in an 
upward direction and starts to experience higher volume on days of lower closing prices usually indicates an 
end to the current trend. Look for changes or breakouts in OBV trends. Sell short when the OBV makes a 
downside breakout and buy long when the on OBV upside breakouts. 
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Parabolic SAP (Stop-And-Reverse) 

Developed by Welles Wilder, creator of RSI and DMI, the Parabolic SAR sets trailing price stops for long or 
short positions. Also referred to as the stop-and-reversal Indicator (SAR stands for "stop and reversal"), 
Parabolic SAR Is more popular for setting stops than for establishing direction or trend. Wilder recommended 
establishing the trend first, and then trading with Parabolic SAR In the direction of the trend. If the trend Is up, 
buy when the Indicator moves below the price. If the trend Is down, sell when the Indicator moves above the 
price. 

The formula Is quite complex, but Interpretation Is relatively straightforward. The dotted lines below the price 
establish the trailing stop for a long position and the lines above establish the trailing stop for a short position. 
At the beginning of the move, the Parabolic SAR will provide a greater cushion between the price and the 
trailing stop. As the move gets underway, the distance between the price and the Indicator will shrink, thus 
making for a tighter stop-loss as the price moves In a favorable direction. 

There are two variables: the step and the maximum step. The higher the step Is set, the more sensitive the 
Indicator will be to price changes. If the step Is set too high, the Indicator will fluctuate above and below the 
price too often, making Interpretation difficult. The maximum step controls the adjustment of the SAR as the 
price moves. The lower the maximum step Is set, the further the trailing stop will be from the price. Wilder 
recommends setting the step at .02 and the maximum step at .20. 
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RS - Relative Strength (comparative) 

Compares the performance trend of a stock or industry group relative to another stock, group or index. This 
comparison removes the emotion from the marketplace. Many times a drop in relative strength can indicate a 
coming drop in actual price of the security. Do not confuse with Wilderss RSI. 

The concept is to identify which stock or market sector is performing the best. Assuming that trends will 
continue to persist for some time, it is more probable that before a stock price will drop sharply it will first loose 
relative strength against other stocks. This would indicate a sell prior to such a price drop. An increase in 
relative strength does not necessarily indicate that the index is heading up, but it does signal a buy alert. 
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RSI - Relative Strength Index 

A technical indicator developed by Welles Wilder to help investors gauge the current strength of a security 
price relative to its past performance. The RSI is an excellent overbought/oversold indicator that can be used 
to predict trend reversal points. Do not confuse this index with relative strength in its everyday definition as 
used in comparing the movement of one security, index or group against the movement of another security, 
index or group. Developed by J. Welles Wilder, Jr. and first described in his book "New Concepts in Technical 
Trading Systems", this is a momentum oscillator that measures the velocity of directional price movement. 

It compares a security highest highs and lowest lows over a period of time. RSI is based upon the difference 
between the average of the closing price on up days vs. the average closing price on the down days. 

RSI=100-[100/(1+U/D)] 

U = average of upward price closes (EMA of gains) 

D = average of downward price closes (EMA of losses) 

The ratio between up and down closing averages is in fact the makeup of the index. The time period specified 
determines the volatility of the RSI. For example, a 9-day time period will be more volatile than a 21 -day time 
span. The author (Wilder) uses an n value of 14 days but other values may be used that better fit particular 
securities. The 9-day and 25-day RSIs have also gained popularity. Because you can vary the number of time 
periods in the RSI calculation, I suggest that you experiment to find the period that works best for you. 

The RSI is a price-following oscillator that ranges between 0 and 100. A popular method of analyzing the RSI 
is to look for a divergence in which the market index is making a new high, but the RSI is failing to surpass its 
previous high. This divergence would be an indication of an impending reversal. When the RSI then turns 
down and falls below its most recent trough, it is said to have completed a failure swing. The failure swing 
would be considered a confirmation of an impending reversal. 

In Mr. Wilder's book, he discusses five uses of the RSI in analyzing commodity charts (these apply to indices 
as well): 

1. Tops and Bottoms: RSI readings above 70 indicate the shares are overbought and are likely to start falling. 
Readings below 30 indicate the shares are oversold and a rally can be expected. (AmiBroker automatically 
draws horizontal lines at these levels). The RSI usually forms these tops and bottoms before the underlying 
price chart. 

2. Chart Formations: The RSI often forms chart patterns (such as head and shoulders or rising wedges) that 
may or may not be visible on the price chart. 

3. Failure Swings: This is where the RSI surpasses a previous high (peak) or falls below a recent low (trough). 

4. Support and Resistance: The RSI shows, sometimes more clearly than the price chart, levels of support 
and resistance. 

5. Divergence: As discussed above, this occurs when the price makes a new high (or low) that is not 
confirmed by a new RSI high (or low). 
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ROC - Price Rate Of Change 

This indicator dispiays the rate-of-change of a securitys price. Change is dispiayed as a percentage rather 
than as a ratio. 

ROC is caicuiated by dividing the price change over the iast n-periods by the ciosing price n-periods ago. This 
gives you percentage that the price has changed in the iast n-periods. 

When the 10-day ROC iine is above the centrai iine, the price is higher today than it was 10 periods ago. 

When the ROC iine is beiow the centrai iine, the price is iower today than it was 10 days ago. if the ROC iine 
is above the centrai iine, the price is higher than it was 10 days ago. if the ROC iine is beiow the centrai iine 
but rising, the price is stiii iower today than it was 10 days ago, but the range is narrowing. 

The 12-day ROC is best used as a short to intermediate-term overbought/oversoid indicator. The higher the 
ROC, the more overbought the security; the iower the ROC, the more iikeiy a raiiy. However, as with aii 
overbought/oversoid indicators, it is best to wait for the market to begin to correct (i.e., turn up or down) before 
piacing your trade. A market that appears overbought may remain overbought for some time, in fact, 
extremeiy overbought/oversoid readings usuaiiy impiy a continuation of the current trend. 

The 12-day ROC tends to be very cyciicai, osciiiating back and forth in a fairiy reguiar pattern. Often, price 
changes can be anticipated by studying the previous cycies of the ROC and reiating the previous cycies to the 
current market. 

The optimum overbought/oversoid ieveis (e.g., -i-/-5) wiii vary depending on the security being anaiyzed and 
overaii market conditions, in strong buii markets, it is usuaiiy beneficiai to use higher ieveis, perhaps -i-l 0 and 
-5. 
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Stochastic Slow 


Stochastic is an osciiiator that measures the position of a stock or security compared with its recent trading 
range indicating overbought or oversoid conditions. 


it dispiays current day price at a percentage reiative to the securitys trading range (high/iow) over the 
specified period of time. 


FastStoc = %K = 


(today's close)-(low price in period n) 
(high price in period n) - (low price in periodn) 


in a Siow Stochastic, the highs and iows are averaged over a siowing period. The defauit is usuaiiy 3 for siow 
and 1 (no siowing) for fast. The iine can then be smoothed using an exponentiai moving average, Weighted, 
or simpie moving average %D. Confirming Buy/seii signais can be read at intersections of the %D with the %K 
as weii. 


The Stochastic Osciiiator aiways ranges between 0% and 100%. A reading of 0% shows that the security's 
dose was the iowest price that the security has traded during the preceding x-time periods. A reading of 100% 
shows that the security's ciose was the highest price that the security has traded during the preceding x-time 
periods. When the ciosing price is near the top of the recent trading range (above 80%), the security is in an 
overbought condition and may signai for a possibie correction. Oversoid condition exists at a point beiow %20. 
Prices ciose near the top of the range during uptrends and near the bottom of the range during downtrends. 
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TRIM - Arms Index 

Trading Index, a technical measure of advances and declines within the market. TRIM takes into account the 
number and volume of issues that advanced in price, and the number and volume of issues that declined in 
price. This index measures the relative strength of volume associated with advancing stocks against the 
strength of volume associated with declining stocks. 

Exact AFL formula for TRIM is: 

Armsindex = ( AdvIssuesO / DecIssuesO ) / ( AdvVolumeO / DecVolume ) ); 

A TRIM value of 1 indicates that the ratio of up volume to down volume is equal to the ratio of advancing 
issues to the declining issues and the market is in a neutral condition. A neutral condition simply means that 
the up volume is equally distributed over the advancing issues and that the down volume is equally distributed 
over declining issues for the day. 

This indicator, although simple in its formulation, requires much study in its application. There are many 
variations applied to the TRIM. Many analysts use a 10-day moving average of TRIM as an indicator. 
AmiBroker plots two different averages for TRIM with the default averaging periods of 15 and 45. A reading of 
less than 1.0 usually indicates a bullish demand while a reading greater than 1 can signify a bearish market 
condition. It must be kept in mind that the indicator behavior and its reading and interpretation depends on 
whether the market is in a bullish or bearish phase. The actual time duration of this market phase must also 
be considered. Do not attempt to make and buy or sell decisions based on movements of this indicator by 
itself. 

See also AFL Function reference: AFL Function: trinQ 


TRIM - Arms Index 


496 


AmiBroker 6.00 User's Guide 


Technical analysis guide 


TRIX - TRIple exponential 

TRI-ple exponential. TRIX displays the % rate-of-change of a triple exponentially smoothed moving average 
of the closing price of a security. 

TRIX is calculated as a one period rate of change of the third exponential moving average pass of the closing 
price. 

TRIX is designed to filter out insignificant cycles - those smaller than the number of moving averages 
specified. The TRIX indicator oscillates around a zero line. Trades should be placed when the indicator 
changes direction. 
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Ultimate Oscillator 

Larry Williams, the designer of the Ultimate Oscillator, wanted to address the problems experienced with most 
oscillators when used over different lengths of time. 

Ultimate oscillator signals are the following: divergence and a breakout in the Oscillator's trend, as well as 
overbought and oversold levels. 

The value of other oscillators can vary greatly depending on the number of time periods used during the 
calculation. So, the Ultimate Oscillator, uses weighted sums of three oscillators which represent short, 
intermediate, and long term market cycles (7, 14, & 28-period), and it is plotted as a single line on a vertical 
scale of 0 to 100. 

The three components are based on Williams's definitions of buying and selling "pressure." 

A trade should be initiated following a divergence and a breakout in the Ultimate Oscillator's trend. 

Signals: 

A Buy signal is generated when: 

A positive or bullish divergence occurs between the Ultimate oscillator and the price. 

The Ultimate falls below 30 and then rises above the previous high established during the divergence (the 
actual buy signal). 

A Sell Signal is offered when: 

A negative or bearish divergence occurs between the Ultimate and the price. 

The Ultimate rises above 70 and then falls below the previous low established during the divergence (the 
actual sell signal). 

Closing existing positions: 

Close long positions when the Ultimate exceeds 70. 

Close short positions when the Ultimate goes below 30. 

As with most indicators, it is good if these signals are confirmed by other indicators before being acted upon. 
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VAP - Volume At Price histogram 

Volume At Price histogram is also known as "Volume Profile" chart. 

To turn it on simply go to Tools->Preferences and change Type of the VAP from "NONE" to "Left-side solid 
area chart, behind" for example 

VAP shows total volume of trading that occurred at given price level. VAP is calculated from data bars that are 
currently visible. 

Actual algorithm involves not ONE price but High-Low price RANGE. 

AmiBroker DISTRIBUTES equally bar's volume over High-Low range to produce VAP histogram. For example 
if bar's volume is 10000 and H-L range spans 3 'lines" of VAP histogram than each of 3 lines 
involved gets added 10000/3 to produce statistics. This gives much more accurate results than using single 
price 

as some other implementations do. 

To turn VAP on/off use: Tools->Preferences->Main chart 

You can also add VAP to your own custom charts using PlotVAPOverlay AFL function. 
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Relative Performance chart 

Relative Performance chart compares the rate of price change of two or more tradable instruments. Plot starts 
with 0% at the very first visible bar and shows percentage change of closing price since that point for every 
symbol in the list. Relative perfomrance charts are great for comparing dissimimilarly priced issues (for 
example stocks and indices) since it displays percentage changes, not absolute values. You can easily see 
which instruments perform better than others and choose best performers for your trading. 

You can adjust the list of symbols that are plotted in the Relative Performance chart by clicking with RIGHT 
mouse button over the chart and choosing "Parameters" item from the context menu. In the Parameters dialog 
you can enter a comma-separated list of symbols that you want to get the chart for. There is no limit on 
number of symbols you can enter, but please remember to separate symbols by comma and not using spaces 
unless symbol itself has them. 
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AmiBroker is equipped with a powerfui formuia ianguage aiiowing you to write trading system ruies, define 
your own indicators and custom commentaries. This chapter expiains the ianguage, gives you detaiied 
reference of built-in analysis functions and shows how to use AFL-tools such as automatic analyzer and 
formula editor. 

• Language Reference 

♦ Basics (lexical elements, predefined variables) 

♦ Keywords 

• Function Reference 

♦ Alphabetical list of all AFL functions 

♦ Categorized list of AFL functions 

♦ AddToComposite function - creating multiple security statistics 

♦ Equity functon - analysing your trading system performance 

♦ Variable-period functions 

• User-defined functions and variable scope 

• AFL Tools 

• AFL Scripting Flost 

• Component Object Model support in AFL 

• Common coding mistakes 

• Advanced portfolio backtester interface 

• Adding custom backtester metrics 

• Using Low-level graphics functions 

See also: Tutorial: Understanding how AFL works 
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AFL Reference Manual 
Introduction 

AFL is a special programming language used to define and create custom indicators, scans, explorations, 
back-tests and guru commentaries. 

Basics 

Lexical elements 

This chapter describes the different categories of word-like units (tokens) recognized by the AFL language 
interpreter. 

Whitespace 

Whitespace is the collective name given to spaces (blanks), tabs, new line characters and comments. 
Whitespace can serve to indicate where tokens start and end, but beyond this function, any surplus 
whitespace is discarded. 

Comments 

Comments are pieces of text used to annotate a program. Comments are for the programmer's use only; they 
are stripped from the source code before parsing. The are two ways to delineate comments: C-like comments 
and C-i-i- like comments. A C-like comment is any sequence of characters placed after the symbol pair /*. The 
comment terminates at the first occurrence of the pair 7 following the initial /*. The entire sequence, including 
the four comment-delimiter symbols, is replaced by one space. A C-i-i- like comments are single-line 
comments that start by using two adjacent slashes (//) in any position within the line and extend until the next 
new line. 

AFL does not allow nested comments. 

Tokens 

AFL recognizes five classes of tokens: 

• identifiers 

• constants 

• string-literals 

• operators 

• punctuators (also known as separators) 

Identifiers are arbitrary names of any length given to functions and variables. Identifiers can contain the letters 
(a-z, A-Z), the underscore character ("_"), and the digits (0-9). The first character must be a letter. 

AFL identifiers are NOT case sensitive. 

Constants are tokens representing fixed numeric or character values. Numeric constants consist of decimal 
integer and optionally: decimal point and decimal fraction part. Negative numeric constants have unary minus 
(-) prefixed. 

String constants, also known as string literals, form a special category of constants used to handle fixed 
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sequences of characters and are written as a sequence of any number of characters surrounded by double 
quotes: 


"This is literally a string" 

The null (empty) string is written The characters inside the double quotes can include escape sequences 
("\n" - a new line escape sequence). 

A Constant expression is an expression that always evaluates to a constant. They are evaluated just as 
regular expressions are. 

Punctuator (also known as separator) in AFL is one of the following characters: 

(),;=■ 

Parentheses (open ( and close )) group expressions, isolate conditional expressions and indicate function 

calls and function parameters: 

d = c*(a + b)/* override normal precedence */ 

a= (b AND c) OR (d AND e) /* conditional expression 7 

func() /* function call no arguments 7 

The comma (,) separates the elements of a function argument list 

The semicolon (;) is a statement terminator. Any legal AFL expression followed by a semicolon is interpreted 
as a statement, known as expression statement. The expression is evaluated and its value 
is discarded (except Guru Commentaries where string values are written to output window) 

The dot(.) is a member access operator. It is used to call COM object methods. If myobj variable holds the 
object, using dot operator we can call the methods (functions) of myobj object: 

myobj.MethodO; 

The equal sign (=) separates variable declarations from initialization lists: 
x = 5; 

It also indicates the default value for a parameter (see built-in function description): 
macd( fast = 12; slow = 26 ) /* default values for fast and slow arguments) 

Language structure 

Each formula in AFL contains of one or more expression statements. Each statement MUST be terminated by 
semicolon (;). In this way you are able to break long expressions into several physical lines (in order to gain 
clarity) and AmiBroker will still treat it like a single statement until terminating semicolon. Examples: 


X = ( y + 3 ) ; 

X = y = 0; 

proc( argl, arg2 ); 

y=z= (f{x) +3 


/* X is assigned the value of y + 3 */ 

/* Both X and y are initialized to 0 */ 

/* Function call/ return value discarded */ 
/* A function-call expression */ 


my_indicator = Ilf ( MACD {) > 0, 
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Close - MA(Close,9), 

MA( Close, 9 ) - Close ); 

/* one statement in several lines */ 


Identifiers 

Identifiers in AFL are used to identify variables and functions. 

There are some predefined identifiers referencing built-in arrays and functions. 

The most important are price array identifiers. They identify specific price fields that the formula should 
operate on. The valid price array identifiers are open, high, low, close, volume, openint, average. Price 
array identifiers can be abbreviated as shown in the following table. Note that these are not case-specific. 



Examples of the use of price array identifiers in formulas are shown below. 

MA( Close, 10 ); IIf( H > Ref(H,-l), MA(H,20), MA(C,20) ); 

Operators 
Comparislon operators 

Comparision operators are divided into two types: 

• relational ( <, >, <=, >= ) 

• equality ( ==, != ) 



These operators give true (1) or false (0) value as a result of comparison. 
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Assignment operator 


Symbol I Meaning 


Store the value of the second operand in the object specified by the first 
operand (“simple assignment”). 

The assignment operator assigns a value to a variable: 

result = expression; 

where result is variable identifier and expression is any numerical, array or text expression. 

As the = operator behaves like other operators, expressions using it have a value in addition to assigning that 
value into variable. This means that you can chain assignment operators as follows: 
j = k = l = 0; 

j, k, and I equal zero after the example statement is executed. 

Attention: please DO NOT confuse assignment operator (=) with equality check (==) 

These are two different operators and you must not use assignment (=) to check for equality. 

if( Name() = "MSFT") // WRONG !!! - variable assignment operator used instead of equality check 

{ 

} 

if( Name() == "MSFT") // CORRECT - equality operator used properly 

{ 

} 

This is one of common coding mistakes listed here. 

Arithmetic operators 

Formulas can contain the following mathematical operators: 


Symbol 

Meaning 

+ 

Addition 

- 

Subtraction (or negative value) 

* 

Multiplication 

/ 

Division 

% 

Modulus (or remainder) (AFL 1.7+) 

A 

Exponentiation (raising to a power) 

1 

Bit-wise "Or" (AFL 2.1+) 

& 

Bit-wise "And" (AFL 2.1+) 
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The following formulas illustrate the use of operators in a formula: 

varl = ( H + L ) / 2; 

var2 = MA (C, 10) -MA (C, 20) / (H + L + C) ; 
var3 = Close + ((1.02 * High)-High); 

Logical operators 


Symbol I Meaning 


NOT Logical "Not" - gives "True" when operancf is equal to false 

AND Logical "And" - gives "True" result if BOTH operands are true at the same time 

OR Logical "Or" - gives "True" result if ANY of operands is true 

If a formula requires multiple conditions, you can combine the conditions with AND and OR operators. For 
example, maybe you'd like to plot a +1 when the MACD is greater than zero and the RSI is greater than 70: 

Condition = MACD () > 0 AND RSI (14) > 70; 

You can add as many conditions within a formula as you like. 

Compound assignment operators 

Introduced in version 5.00, the compound operatos are specifeid in the form of: 
destinvar op= expr; 

where destinvar is the variable, expr is the expression, and op is one of the following artithmetic operators: +, 

*, /, %, &. I 

The destinvar op= expr form behaves as: 
destinvar = destinvar op expr; 

This is shortcut form for common assignment statements like k = k + 2; so you can write it shorter as: 
k+=2; 

and it will work the same but little faster. 

Full list of available assignment operators is here: 


No 

Symbol 

Meaning 

1 


Store the value of the second operand in the object specified by the first 


operand (“simple assignment”). 

O 

* 

Multiply the value of the first operand by the value of the second 



operand; store the result in the object specified by the first operand. 

3 

/= 

Divide the value of the first operand by the value of the second operand; 
store the result in the object specified by the first operand. 
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4 

%= 

Take modulus of the first operand specified by the value of the second 
operand; store the result in the object specified by the first operand. 

5 

+ = 

Add the value of the second operand to the value of the first operand; 
store the result in the object specified by the first operand. 

6 

-= 

Subtract the value of the second operand from the value of the first 
operand; store the result in the object specified by the first operand. 

7 

&= 

Obtain the bitwise AND of the first and second operands; store the result 
in the object specified by the first operand. 

8 

1= 

Obtain the bitwise inclusive OR of the first and second operands; store 
the result in the object specified by the first operand 


typeofO operator 

The typeof operator is used in the foliowing way: 
typeof (operand) 

The typeof operator returns a string indicating the type of the *unevaluated* operand, operand is the string, 
variable, function identifier, or object for which the type is to be returned. 

When supplying identifier, it should be provided alone, without arithmetic operators, without extra arguments 
and without braces. 

If you want to check the type of value returned by the function, you must first assign the return value to a 
variable and then use 
typeof( variable). 

Possible return values are: 

• "undefined" - identifier is not defined 

• "number" - operand represents a number (scalar) 

• "array" - operand represents an array 

• "string" - operand represents a string 

• "function" - operand is a built-in function identifier 

• "user function" - operand is a user-defined function 

• "object" - operand represents COM object 

• "member" - operand represents member function or property of COM object 

• "handle" - operand represents Windows handle 

• "unknown" - type of operand is unknown (should not happen)typeof operator allows among other 
things to detect undefined variables in the following way 

if ( typeof ( somevar ) == "undefined" ) 

{ 

/// when somevar is undefined the code here will execute 
} 


The following sample COMMENTARY code shows the output of typeof() in some common situations: 


X = MACD (); 

y = LastValue ( x ); 

function testfunO { return 1; }; 
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printf ( typeof ( test ) + "\n" ); // the undefined variable 

printf ( typeof ( 1 ) + "\n"); // literal number 

printf ( typeof ( "checking" ) + "\n"); // literal string 

printf ( typeof ( x ) + "\n"); // array variable 

printf ( typeof ( y ) + "\n"); // scalar variable 

printf ( typeof ( MACD ) + "\n"); // function identifier 

printf ( typeof ( testfun ) + "\n" ); // user function identifier 

Operator precedence and the parentheses 

AFL supports parentheses in formulas. 

Parentheses can be used to control the operation precedence (the order in which the operators are 
calculated). AmiBroker always does operations within the innermost parentheses first. When parentheses are 
not used, the precedence is as follows (higher precedence listed first): 


No 

Symbol 

Meaning 

1 

+ + 

Post-increment/pre-increment 
(i++ works like i = i + 1) 

2 

- 

Post-decrement/pre-decrement 
(i- works like i = i -1 ) 

3 

[] 

Array element (subscript) operator 

4 

A 

Exponentiation 

5 

- 

Negation - Unary minus 

6 

* 

Multiplication 

7 

/ 

Division 

8 

% 

Reminder (Modulo operator) 

9 

+ 

Addition 

10 

- 

Subtraction 

11 

< 

Less than 

12 

> 

Greater than 

13 

<= 

Less than or equal to 

14 

>= 

Greater than or equal to 

15 

== 

Equal to 

16 

!= 

Not equal to 

17 

& 

Bit-wise "And" (AFL2.U) 

18 

1 

Bit-wise "Or" (AFL2.U) 

19 

NOT 

Logical "Not" 

20 

AND 

Logical "And" 

21 

OR 

Logical "Or" 
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22 

Variable assignment operator 

%= 

23 += 

Compound assignment 

& = 


l= 



The expression 


H + L / 2; 

(without parenthesis) wouid be caicuiated by AmiBroker as "L / 2" pius "H", since division has a higher 
precedence. This wouid resuit in a much different vaiue than 

(H + L) /2; 


A few words about increment/decrement operators. There are two kinds of them: postfix and prefix. 

The unary operators (++ and --) are caiied “prefix” increment or decrement operators when the increment or 
decrement operators appear before the operand. Postfix increment and decrement has higher precedence 
than prefix increment and decrement operators. When the operator appears before its operand, the operand 
is incremented or decremented and its new vaiue is the resuit of the expression. 

i = 5; 

j = ++i; // i will be incremented first and result (number 6) will be assigned to 

j • 

The resuit of the postfix increment or decrement operation is the vaiue of the postfix-expression before the 
increment or decrement operator is applied. The type of the result is the same as that of the 
postfix-expression but is no longer an l-value. After the result is obtained, the value of the operand is 
incremented (or decremented). 

i = 5; 

j = i++; // j will be assigned the value of 5 (before incrementation) and then i 
will be incremented to 6. 

Accessing array elements: [ ] - subscript operator 

An array identifier followed by an expression in square brackets ([ ]) is a subscripted representation of an 
element of an array object. 

arrayidentifier [ expression ] 

It represents the value of expression-th element of array. 

BarCount constant gives the number of bars in array (such as Close, High, Low, Open, Volume, etc). Array 
elements are numbered from 0 (zero) to BarCount-1. 
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To get the first bar you can use array[ 0 ], to get the last bar of array you can use array[ BarCount -1 ]; 

For example: 

Close[ 5 ]; 

Represents the sixth element (bar) of the close array. 

Closet 0 ]; 

Represents the very first available bar of the close array. 

Right BarCount - 1 ]; 

Represents the last bar of Fligh array. 

Matrices and Matrix operators 

Matrices are two-dimensional arrays of numbers. 

To create a matrix use: 

my_var_name = Matrix ( rows, cols, initvalue); 

To access matrix elements, use: 

mY_var_name t row ] t col ]; 

where 

row is a row index (0... number of rows-1) 
and 

col is a column index (0... number of columns-1) 

Matrices and their elements support all scalar (element-wise) arithmetic and logical operations. 

All these standard operators are performed on matrices element-wise. For that reason for example to add two 
matrices they must be the same size (the number of rows and columns must be the same). If they are not the 
same it is up to you how to perform calculation on each element via loop. 

So you can for example add, subtract, multiply, divide two matrices if they have same dimensions with one 
call. 

X = Matrix ( 5, 6, 9 ); // matrix 5 rows 6 columns, initial value 9 
y = Matrix ( 5, 6, 10 ); // matrix 5 rows 6 columns, initial value 10 

z = y - z; // will give you matrix 5 rows and 6 columns filled with elements 
holding value 1 (difference between 10 and 9) . 

All those operations are performed ELEMENT-WISE. 

You can also apply any arithmetic and logical operation on matrix AND scalar value. This would perform 
element-wise 

operation on each element of source matrix and given scalar value. 
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m = Matrix ( 
z = m; II z 

for ( i = 0 ; 

{ 

z[ i ][ 4 


10, 10, 0 ); II m. will be 10x10 matrix filled with zeros 
is now also a matrix 

i < 10; i++ ) 

] = i; // fill z with some other values, note that m will remain 


unaffected. 


} 


for ( i = 0; i < 10; i++ ) 

_TRACEF ( "%g = %g, %g, %g\n", i, m[i][l], m[ i][4], z[ i][4]); 


// scalar addition (element wise) 
z += 3 ; 
m += 5 ; 


for ( i = 0; i < 10; i++ ) 

_TRACEF ( "%g = %g, %g, %g\n", i, m[i][1], m[ i][4], z[ i][4]); 

There is one special operator that works only on matrices - it is matrix product. The operator for matrix 
product is @ (the 'at' sign). Matrix product is the linear algebra way to multiply matrices. If you write C = A @ 
B, it multiplies matrix A(n,k) by matrix B(k,m) to produce matrix C(n,m) so the number of columns in matrix A 
must be equal to number of rows in matrix B. For more info see: 

https://en.wikipedia.org/wiki/Matrix_multiplication The precedence of matrix product @ operator is the same 
as * (so it has higher precedence than addition and subtraction). 


A = Matrix ( 1 , 3 ) ; 
B = Matrix ( 3 , 2 ) ; 


II 

matrix 

A 

= [ : 

1, 4, 

6 

] 



// 

matrix 

B 

= 







// 

[ 

2, 3 

] 








// 

[ 

5, 8 

] 








// 

[ 

7, 9 

] 








A[ 

0 

] [ 0 

] 

= 1; 

A[ 

0 

] 

[ 

1 ] 

= 4; 

B[ 

0 

] [ 0 

] 

= 2; 

B[ 

0 

] 

[ 

1 ] 

= 3; 

B[ 

1 

] [ 0 

] 

= 5; 

B[ 

1 

] 

[ 

1 ] 

= 8; 

B[ 

2 

] [ 0 

] 

= 7; 

B[ 

2 

] 

[ 

1 ] 

= 9; 

X ^ 


A @ B; 









_TRACEF ( "^ 

hg 

%g''. 

X[ 

0 

] 

[ 

0 ] 

, X[ 


Compound statements (Blocks) 

A compound statement consists of zero or more statements enclosed in curly braces ({}). A compound 
statement can be used anywhere a statement is expected. Compound statements are commonly called 
“blocks.” 
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{ 


statementi; 


statementN; 


} 

(this is 'borrowed' from C ianguage, users of other programming ianguages are used to use BEGiN for { and 
END for}) 

if ( Amount > 100 ) 

{ 

_TRACE ( "Amount above 100"); 

Balance = Balance + Amount; 

} 

else 

Balance = Balance - Amount; 

Built-in Functions 

in addition to mathematicai operators, AmiBroker contains over 70 buiit-in functions that perform mathematicai 
operations. 

The foiiowing formuia consists of a singie function that gives the square roots of the dosing prices: 

sqrt ( Close ); 

The foiiowing formuia consists of a singie function that gives a 14-period RSi indicator: 


GraphO = RSI (14); 


The foiiowing formuia consists of two functions. The resuit is the difference between the MACD indicator and 
a 9-period exponentiai moving average of the MACD: 

GraphO = MACD () - EMA(MACD 0,9); 

Aii function caiis must consist of function identifier (name) foiiowed by a pair of parentheses. 

As has been eiuded to in eariier exampies, a function can be "nested" within a function. The nested function 
can serve as the main function's data array parameter. The foiiowing exampies show functions nested within 
functions: 

MA ( RSI (15) , 10 ); 

MA( EMA( RSI (15), 20), 10 ); 

The first exampie caicuiates a 10-period simpie moving average of a 15-period Reiative Strength index (RSi). 
The second exampie caicuiates a 20-period exponentiai moving average of a 15-period RSi, and then 
caicuiates a 10-period simpie moving average of this moving average. 
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Conditional function IIF() 

The iif() function is used to create conditional assignments. It contains three parameters as shown in the 
foiiowing exampie. 

dynamicrsi = IIf( Close > MA(C,10), RSI (9), RSI (14) ); 

The above "iif" statement reads (in Engiish) as foilows: If today's close is greater than today's 10-day simple 
moving average of the close, then assign a 9-day RSI to the dynamicrsi variable, otherwise, assign a 14-day 
RSI. The next formula assigns positive volume to vo/resu/f variable if the close is greater than the median 
price. Otherwise, "negative volume" is assigned. 

volresult = IIf( Close > (High+Low) /2 , Volume, -Volume ); 

If you simply want an expression to be evaluated as either true or false, it can be done without the use of the 
iif() function. The following formula will result in either a 1 (true) or a 0 (false): 

result = RSI (14) > 70; 

The same done with iif() gives the same results, but the formula is longer. 

result = Ilf (RSI (14) >70, 1, 0 ); 

Please note that IIF is a function - so the result of evaluation is returned by that function and should be 
assigned to some variable. 

Ilf always evaluates both TRUE_PART and FALSE_PART, even though it returns only one of them. Because 
of this, you should watch for undesirable side effects. IIF function Is NOT a flow-control statement. If you 
need flow control (conditional execution of some code parts) you should look for If-else conditional statement 
described later in this document. 

The following example shows one common error made with IIF function: 

IIf( condition, result = 7, result = 9 ); // THIS IS WRONG 

Correct usage is: 

result = IIf( condition, 7, 9 ); 

/* 7 or 9 is ‘returned* and assigned to resu/f variable depending on condition */ 


Variables 

In order to shorten, simplify, enhance, and make the maintenance of complex formulas easier, you may want 
to use variables. In fact using variables you can significantly improve formula calculation speed. So it is 
strongly recommended to use variables and there is no limit on number of variables you can define. 

A variable is an identifier that is assigned to an expression or a constant. The number of variables used in a 
formula is not limited. Variables must be assigned before the variable is used in the formula. Variables cannot 
be assigned within a function call. 
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User-defined variable names (identifiers) cannot duplicate names already used by functions (e.g., ma, rsi, cci, 
iif, etc.) or predefined array identifiers (e.g., open, high, low, close, simple, o, c, I, h, s, a). 


Reserved variables 


AmiBroker uses some reserved variable names in its formulas, for example in Auto-Analysis window you have 
to assign values to 2 variables named 'buy' or 'sell' to specify the conditions where "buy" and "sell" conditions 
occur. For example (system that buys when MACD rises above 0 line, and sells when MACD falls below 0 
line) 


Buy = Cross ( MACD (), 0 ); 

Sell = Cross! 0, MACD () ); 

AmiBroker uses the following reserved variable names. Please note that variables marked as obsolete should 
NOT be used in new coding. They are left for backward compatibility only and new formulas should use 
modern functions like PlotQ to plot indicators and AddColumnQ to define exploration columns. 


Variable 

Usage 

Applies to 

buy 

defines "buy" (enter long position) trading rule 

Automatic 

Analysis, 

Commentary 

sell 

defines "sell" (close long position) trading rule 

Automatic 

Analysis, 

Commentary 

short 

defines "short" (enter short position - short sell) trading rule 

Automatic 

Analysis 

cover 

defines "cover" (close short position - buy to cover) trading rule 

Automatic 

Analysis 

buyprice 

defines buying price array (this array is filled in with the default values 
according to the Automatic Analyser settings) 

Automatic 

Analysis 

sellprice 

defines selling price array (this array is filled in with the default values 
according to the Automatic Analyser settings) 

Automatic 

Analysis 

shortprice 

defines short selling price array (this array is filled in with the default 
values according to the Automatic Analyser settings) 

Automatic 

Analysis 

coverprice 

defines buy to cover price array (this array is filled in with the default 
values according to the Automatic Analyser settings) 

Automatic 

Analysis 

title 

defines title text (overrides any graphA/name) 

Indicators 

tooltip 

Obsolete in 5.40. Use Data window instead or use PlotQ with 
styleHidden if you want to add your custom values to data tooltip. 

Indicators 

graphxspace 

defines percentage extra space added at the top and the bottom of the 
chart 

Indicators 

graphzorder 

GraphZOrder variable allows to change the order of plotting indicator 
lines. When GraphZOrder is not defined or is zero (false) - old ordering 
(last to first) is used, when GraphZOrder is 1 (true) - reverse ordering is 
applied. 

Indicators 

exclude 

If defined, a true (or 1) value of this variable excludes current symbol 
from scan/exploration/back test. They are also not considered in buy and 

Automatic 

Analysis 
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hold calculations. Useful when you want to narrow your analysis to 
certain set of symbols. 


roundlotsize 

defines round lot sizes used by backtester (see explanations below) 

Automatic 
Analysis (new in 
4.10) 

ticksize 

defines tick size used to align prices generated by built-in stops (see 
explanations below) (note: it does not affect entry/exit prices specified by 
buyprice/sellprice/shortprice/coverprice) 

Automatic 
Analysis (new in 
4.10) 

pointvalue 

allows to read and modify future contract point value (see backtesting 
futures) 

CAVEAT: this AFL variable is by default set to 1 (one) regardless of 
contents of Information window UNLESS you turn ON futures mode 
(SetOption("FuturesMode", True)) 

Automatic 
Analysis (new in 
4.10) 

margindeposit 

allows to read and modify future contract margin (see backtesting 
futures) 

Automatic 
Analysis (new in 
4.10) 

positionsize 

Allows control dollar amount or percentage of portfolio that is invested 
into the trade (more information available in the "Tutorial: Backtesting 
your trading ideas") 

Automatic 
Analysis (new in 
3.9) 

positionscore 

Defines the score of the position. More details: "Tutorial: Portfolio 
Backtesting") 

Automatic 

analysis 

numcolumns 

Exploration only: defines the number of your own columns (excluding 
predefined ticker and date columns) and assign the column value to the 
variable 

Automatic 

Analysis 

filter 

Exploration only: controls which symbols/quotes are accepted. If "true" 

(or 1) is assigned to that variable for given symbol/quote it will be 
displayed in the report. 

So, for example, the following formula will accept all symbols with closing 
prices greater than 50 : 

filter = close > 50; 

Automatic 

Analysis 

columnA/ 

(obsolete) 

Exploration only: defines A/th column value. Example: 

columnO = Close; 

Automatic 

Analysis 

columnMormat 

(obsolete) 

Exploration only: allows you to define the formatting applied to numbers. 
By default all variables are displayed with 2 decimal digits, but you can 
change this by assigning a different value to this variable: 1.5 gives 5 
decimal digits, 1.0 gives no decimal digits. So, in our example, typing: 

columnOformat = 1.4; 

will give closing prices displayed with 4 decimal digits. 

(Note for advanced users: the integer part of this number can be used to 
pad formatted number with spaces - 6.0 will give no decimal digits but a 
number space-padded upto 6 characters.) 

Automatic 

Analysis 

columnA/name 

Exploration only: allows you to define the header name. Assigning 
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(obsolete) 

columnOname = "Close"; 

will change the name of the first custom column from the default "Column 
0" to more appropriate "Close". 

Automatic 

Analysis 

maxgraph 

(obsolete) 

specifies maximum number of graphs to be drawn In custom Indicator 
window (default=3) 

Indicators 

graphA/ 

(obsolete) 

defines the formula for the graph number N (where A/ Is a number 

0,1, 2 ,..., maxgraph-1) 

Indicators 

graphA/name 

(obsolete) 

defines the name of A/th graph line. This will appear In the title of the 
chart pane 

Indicators 

graphA/color 

(obsolete) 

defines the color Index of /Vth graph line (color Indexes are related to the 
current palette - see Preferences/Color) 

Indicators 


colorCustomI = 0 
colorCustom2 = 1 
colorCustomS = 2 
colorCustom4 = 3 
colorCustomS = 4 
colorCustome = 5 
colorCustom? = 6 
colorCustomS = 7 
colorCustom9 = 8 
colorCustomI 0 = 9 
colorCustom11=10 
colorCustomI 2 = 11 
colorCustomI 3 = 12 
colorCustomI 4 = 13 
colorCustomI 5 = 14 
colorCustomI 6 = 15 

colorBlack = 16 
colorBrown = 17 
colorDarkOllveGreen = 18 
colorDarkGreen = 19 
colorDarkTeal = 20 
colorDarkBlue = 21 
colorindigo = 22 
colorDarkGrey = 23 

colorDarkRed = 24 
colorOrange = 25 
colorDarkYellow = 26 
colorGreen = 27 
colorTeal = 28 
colorBlue = 29 
colorBlueGrey = 30 
colorGrey40 = 31 
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colorRed = 32 
colorLightOrange = 33 
colorLime = 34 
colorSeaGreen = 35 
colorAqua = 35 
colorLightBlue = 37 
colorViolet = 38 
colorGrey50 = 39 

colorPink = 40 
colorGold = 41 
colorYellow = 42 
colorBrightGreen = 43 
colorTurquoise = 44 
colorSkyblue = 45 
colorPlum = 46 
colorLightGrey = 47 


colorRose = 48 
colorTan = 49 
colorLightYellow = 50 
colorPaleGreen = 51 
colorPaleTurquoise = 52 
colorPaleBlue = 53 
colorLavender = 54 
colorWhite = 55 


graphAtoarcolor 

(obsolete) 

defines the array that holds palette indexes for each bar drawn 

Indicators 

graphA/style 

defines the style of Mh graph. Style is defined as a combination (sum) of 

Indicators 

(obsolete) 

one or more following flags: 



styleLine = 1 - normal (line) chart (default) 

styleHistogram = 2 - histogram chart 

styleThick =4 - fat (thick) 

styleDots = 8 - include dots 

styleNoLine = 16 - no line 

styleLog = 32 - semi-logarithmic scale 

styleCandle = 64 - candlestick chart 

styleBar = 128 - traditional bar chart 

styleNoDraw = 256 - no draw (perform axis scaling only) 

styleStaircase = 512 - staircase (square) chart 

styleSwingDots = 1024 - middle dots for staircase chart 

styleNoRescale = 2048 - no rescale 

styleNoLabel = 4096 - no value label 

stylePointAndFigure = 8192 - point and figure 

(new in 4.20): 

styleArea = 16384 - area chart (extra wide histogram) 
styleOwnScale = 32768 - plot is using independent scaling 
styleLeftAxisScale = 65536 - plot is using left axis scale (independent 
from right axis) 


Language structure 


517 




AmiBroker 6.00 User's Guide AmiBroker Formula Language (AFL) 



Not all flag combinations make sense, for example (64-1-1) (candlestick -i- 
llne) will result In candlestick chart (style=64) 

Note on candlestick/bar charts: these styles use Indirectly 0, H, L arrays 

In addition to graphA/. So ordinary candlestick price chart formula Is 
graphO=close; graph0style=64;. 

But If you want to draw something else than close price you have to 
assign new values to predefined 0,H,L arrays. 


graphA/barcolor 

(obsolete) 

defines the array of color Indexes for the bars and candlesticks In Mh 
graph Ine (color Indexes are related to the current palette - see 
Preferences/Color) 

Indicators 


SEE ALSO: 


• KEYWORDS 

• USER-DEFINABLE PROCEDURES, LOCAL/GLOBAL SCOPE 
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Keywords 

The following are keywords in AmiBroker Formula Language: 
Loops: 


• do (part of do-while statement) 

• while 

• for 

Conditional execution / Flow control: 

• if (part of if-else statement) 

• else (part of if-else statement) 

• switch 

• break (part of the switch statement or for/while statements) 

• case (part of the switch statement) 

• continue (part of for/while statements) 

• default (part of switch statement) 

Functions: 

• function 

• procedure 

• return 

• local (variable scope) 

• global (variable scope) 
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break Keyword 

The break keyword is a part of switch statement and an optional part of looping for , do-while and while 
statements. 

The break keyword terminates the smallest enclosing do, for, switch, or while statement in which it appears. 

break; 

The break statement is used to exit an iteration or switch statement. It transfers control to the statement 
immediately following the iteration substatement or switch statement. 

The break statement terminates only the most tightly enclosing loop or switch statement. In loops, break is 
used to terminate before the termination criteria evaluate to 0. In the switch statement, break is used to 
terminate sections of code — normally before a case label. The following example illustrates the use of the 
break statement in a for loop: 

i = 0; 

while ( i < 10 ) 

{ 

i++; 

// break at step 5 
if ( i == 5 ) 

{ 

break; 

} 

printfC'Step " + i ) ; 

} 

For an example of using the break statement within the body of a switch statement, see The switch 
Statement. 
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case Keyword 

The case keyword is an integral part of switch-case statement. 
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continue Keyword 

The continue keyword is an optional part of for , do-while and while statements. 

It stops the current iteration of a loop, and starts a new iteration. 

continue; 

You can use the continue statement only inside a while, do...while, or for loop. Executing the continue 
statement stops the current iteration of the loop and continues program flow with the beginning of the loop. 
This has the following effects on the different types of loops: 

while and do...while loops test their condition, and if true, execute the loop again, for loops execute their 
increment expression, and if the test expression is true, execute the loop again. 

The following example illustrates the use of the continue statement: 

i = 0; 

while ( i < 10 ) 

{ 

i + +; 

// Skip 5 
if( i == 5 ) 

{ 

continue; 

} 

printfC'Step " + i ) ; 

} 
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default Keyword 

The default keyword is an integral part of switch-case statement. 
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do Keyword 

The do keyword is a part of do-while statement. 

do-while Statement 

The do-while statement lets you repeat a statement or compound statement until a specified expression 
becomes false. 

Syntax 

do sfafemenf while ( expression ); 

The expression in a do-while statement is evaluated after the body of the loop is executed. Therefore, the 
body of the loop is always executed at least once. 

The expression must have numeric or boolean type. Execution proceeds as follows: 

1. The statement body is executed. 

2. Next, expression is evaluated. If expression is false, the do-while statement terminates and control 
passes to the next statement in the program. If expression is true (nonzero), the process is repeated, 
beginning with step 1. 

This is an example of the do-while statement: 


x=100; 

do 

{ 

y = sin ( X ) ; 

X—; 

} while ( X > 0 ); 


In this do-while statement, the two statements y = sin ( x ); and x —; are executed, regardless of the 
initial value of x. Then x > o is evaluated. If x is greater than 0, the statement body is executed again and x 
> 0 is reevaluated. The statement body is executed repeatedly as long as x remains greater than 0. 
Execution of the do-while statement terminates when x becomes 0 or negative. The body of the loop is 
executed at least once. 
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else Keyword 

The else keyword is an optional part of if-else statement. 

if, else Statement 

if( expression) 
statementi 

[else 

statement2\ 

The If keyword executes statementi if expression is true (nonzero); if else is present and expression is false 
(zero), it executes statement2. After executing statementi or statement2, control passes to the next 
statement. 

Example 1 

if ( i > 0 ) 

y = X / i; 

else 

{ 

X = i ; 

y = abs ( X ) ; 


In this example, the statement y = x/i; is executed if i is greater than 0. If i is less than or equal to 0, i is 
assigned to x and abs { x ) is assigned to y. Note that the statement forming the If clause ends with a 
semicolon. 

When nesting If statements and else clauses, use braces to group the statements and clauses into compound 
statements that clarify your intent. If no braces are present, the compiler resolves ambiguities by associating 
each else with the closest If that lacks an else. 


Example 2 


/* without braces */ 


if ( i > 0 ) 

if ( j > i ) 

X = j; 

else 

X = i ; 


The else clause is associated with the inner If statement in this example. If i is less than or equal to 0, no 
value is assigned to x. 


Example 3 


if ( i > 0 


/* With braces */ 


if ( j > i 

X = j; 


else 


X = r ; 
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The braces surrounding the inner if statement in this exampie make the else ciause part of the outer if 
statement. If i is iess than or equai to 0, i is assigned to x. 

Common misunderstandings 

"New if-else problem" 

Question: 

Why I get the syntax error when I write: if( H > Ref(H,-1) ) 

Answer: 


if-eise statement changes fiow of execution (opposite to IIF function that evaiuates aii arguments and works 
on arrays) and you can not reaiiy write 


if ( H >Ref (H, -1) ) 

because it has no meaning. It would translate to " If high array is higher than high array shifted one bar" (see 
tutorial below). Flow control statement (such as if-else) has to get SINGLE boolean value to make decision 
which execution path should be taken. If you write H (or High) it means ARRAY (entire array), 
if you write H[ i ] - it means i-th element of the array. The subscript operator [ ] allows you to access individual 
array elements. 

Instead you should write: 


for ( i = 1; i < BarCount; i++ ) 

{ 

if ( High[ i ] > High[ i - 1 ] ) 

{ 

X[ i ] = High[ i ]; 

} 

else 

{ 


X[ i ] = Low[ i ]; 


} 


} 


this will translate to correct one "for EVERY BAR Y assign i-th element of high array to the i-th element of x 
array if i-th element of high array is higher than the previous element, otherwise assign i-th of low array to the 
i-th element of x array". The rule is: new if-else and w/?//e statements need single boolean value (not array) to 
decide which execution path should be taken. If you want to use them with arrays you have to iterate through 
bars using for loop (as shown above). 

On the other hand this can be implemented in single line using old-style array operations and IIF function: 

X = II f ( High > Ref ( High, -1 ), High, Low ); 

This works because IIF operates on ARRAYS as described in the tutorial. 


As you can see in many cases old-style AFL provides much more compact form. I always tried to explain this 
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advantage of AFL but only a few realised that. New control statements should be used where it is better to 
use them. As I tried to explain during last years in 80% of cases 'old-style' AFL provides the shortest formula. 
Only remaining 20% of cases needed script. Those 'script-only' cases now can be coded in native AFL thanks 
to new for/while/if-else statements. And this is correct usage of them - to replace script parts. 
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for Statement 


The for statement lets you repeat a statement or compound statement a specified number of times. The body 
of a for statement is executed zero or more times until an optional condition becomes false. 

Syntax 

for ( init-expression ; cond-expression ; loop-expression) statement 
Execution of a for statement proceeds as follows: 

1. The init-expression, is evaluated. This specifies the initialization for the loop. There is no restriction on 
the type of init-expression. 

2. The cond-expression, is evaluated. This expression must have arithmetic type. It is evaluated before 
each iteration. Three results are possible: 

• If cond-expression is true (nonzero), statement is executed; then loop-expression, if any, is 
evaluated. The loop-expression is evaluated after each iteration. There is no restriction on its 
type. Side effects will execute in order. The process then begins again with the evaluation of 
cond-expression. 

• If cond-expression is false (0), execution of the for statement terminates and control passes 
to the next statement in the program. 

This example illustrates the for statement: 

myema[ 0 ] = Close[ 0 ]; 
for ( i = 1; i < BarCount; i++ ) 

{ 

myema[ i ] = 0 .1 * Close[ i ] +0.9* myema[ i - 1 ]; 

} 

This example iterates all bars of close array to calculate exponential moving average. 

For loop is extremely flexible. 

loop-expression can be ANY kind of expression you wish. You can produce not only regular series like this: 


for ( i = 0; i < BarCount; i = i + 3 
but you can produce exponential series too: 
for ( i = 1; i < BarCount; i = i * 2 


// increment by 3 every iteration 


// produces series of 1, 2, 4, 8, 16, 32, 
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function Keyword 

The function keyword begins definition of the user-function. 

User-definabie functions aiiow to encapsulate user code into easy-to-use modules that can be user in many 
places without need to copy the same code over and over again. 

Functions must have a definition. The function definition includes the function body — the code that executes 
when the function is called. 

A function definition establishes the name, and attributes (or parameters) of a function. A function definition 
must precede the call to the function. The definition starts with function keyword then follows function name, 
opening parenthesis then optional list of arguments and closing parenthesis. Later comes function body 
enclosed in curly braces. 

A function call passes execution control from the calling function to the called function. The arguments, if any, 
are passed by value to the called function. Execution of a return statement in the called function returns 
control and possibly a value to the calling function. 

If the function does not consist of any return statement (does not return anything) then we call it a procedure. 
Following is an example of function definition: 

// the following function is 2nd order smoother 

function IIR2( input, fO, fl, f2 ) 

{ 

result [ 0 ] = input [ 0 ]; 

result [ 1 ] = input [ 1 ]; 

for ( i = 2; i < BarCount; i++ ) 

{ 

result [ i ] = fO * input [ i ] + 

f1 * result [ i - 1 ] + 
f2 * result [ i - 2 ]; 

} 

return result; 

} 


Plot ( Close, "Price", colorBlack, 

Plot ( IIR2( Close, 0.2, 1.4, -0.6 


styleCandle ); 

), "function example". 


colorRed 


In this code IIR2 is a user-defined function, input, fO, fl, f2 are formal parameters of the functions. 

At the time of function call the values of arguments are passed in these variables. Formal parameters behave 
like local variables. 

Later we have result and i which are local variables. Local variables are visible inside function only. If any 
other function uses the same variable name they won't interfere between each other. 
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The global keyword declares global variable Inside user-defined function. Global variable Is the variable that 
Is visible/accessible Inside the function AND outside the function (at global formula level). 

Due to the fact that AFL by default does not require to declare variables the decision whenever given variable 
Is treated as local or global Is taken depends on where It Is FIRST USED. 

You can however force AFL engine to require all variables to be declared using local or global keywords on 
formula-by-formula basis by placing SetOptlon("RequlreDeclaratlons", True ); at the top of the formula. 

If given Identifier appears first INSIDE function definition - then It Is treated as LOCAL variable. 

If given Identifier appears first OUTSIDE function definition - then It Is treated as GLOBAL variable. 

This default behaviour can be however overriden using global and local keywords (Introduced In 4.36) - see 
example 2. 

Example (commentary): 

k = 4 ; // this is GLOBAL variable 

function f( x ) 

{ 

z = 3; // this is LOCAL variable 

return z * x * k; // 'k' here references global variable k (first used above 
outside function) 

} 

z = 5; // this is GLOBAL variable with the same name as local variable in 
function f 

"The value of z before function call + WriteVal ( z ); 

// Now even if we call function 

// the value of our global variable z 

// is not affected by function call because 

// global variable z and local variable z are separate and 

// arguments are passed by value (not by reference) 

"The result of f( z ) = " + WriteVal ( f( z ) ) ; 

"The value of z after function call is unchanged : " + WriteVal ( z ); 

Example 2: Using local and global keywords to override default visibility rules: 

VariableA =5; // implict global variable 

function Test() 

{ 

local VariableA; // explicit local variable with the same identifier as 
global 
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global VariableB; // explicit global variable not defined earlier 

// may be used to return more than one value from the 

function 

VariableA = 99; 

VariableB = 333; 

} 

VariableB =1; // global variable 

"Before function call"; 

"VariableA = " + VariableA; 

"VariableB = " + VariableB; 

Test () ; 

"After function call"; 

"VariableA = " + VariableA + " (not affected by function call )"; 

"VariableB = " + VariableB + " (affected by the function call )" 


Keywords 


531 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


if Keyword 

The if keyword is an required part of if-eise statement. 

if, eise Statement 

if( expression) 
statementi 

[else 

statement2\ 

The if keyword executes statementi if expression is true (nonzero); if else is present and expression is faise 
(zero), it executes statement2. After executing statementi or statement2, controi passes to the next 
statement. 

Example 1 

if ( i > 0 ) 

y = X / i; 

else 

{ 

X = i ; 

y = abs ( X ) ; 


In this exampie, the statement y = x/i; is executed if i is greater than 0. If i is iess than or equai to 0, i is 
assigned to x and abs { x ) is assigned to y. Note that the statement forming the if ciause ends with a 
semicolon. 

When nesting if statements and else clauses, use braces to group the statements and clauses into compound 
statements that clarify your intent. If no braces are present, the compiler resolves ambiguities by associating 
each else with the closest if that lacks an else. 


Example 2 


/* without braces */ 


if ( i > 0 ) 

if ( j > i ) 

X = j; 

else 

X = i ; 


The else clause is associated with the inner if statement in this example. If i is less than or equal to 0, no 
value is assigned to x. 


Example 3 


if ( i > 0 


/* With braces */ 


if ( j > i 

X = j; 


else 


X = r ; 
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The braces surrounding the inner if statement in this exampie make the else ciause part of the outer if 
statement. If i is iess than or equai to 0, i is assigned to x. 

Common misunderstandings 

"New if-else problem" 

Question: 

Why I get the syntax error when I write: if( H > Ref(H,-1) ) 

Answer: 


if-eise statement changes fiow of execution (opposite to IIF function that evaiuates aii arguments and works 
on arrays) and you can not reaiiy write 


if ( H >Ref (H, -1) ) 

because it has no meaning. It would translate to " If high array is higher than high array shifted one bar" (see 
tutorial below). Flow control statement (such as if-else) has to get SINGLE boolean value to make decision 
which execution path should be taken. If you write H (or High) it means ARRAY (entire array), 
if you write H[ i ] - it means i-th element of the array. The subscript operator [ ] allows you to access individual 
array elements. 

Instead you should write: 


for ( i = 1; i < BarCount; i++ ) 

{ 

if ( High[ i ] > High[ i - 1 ] ) 

{ 

X[ i ] = High[ i ]; 

} 

else 

{ 


X[ i ] = Low[ i ]; 


} 


} 


this will translate to correct one "for EVERY BAR Y assign i-th element of high array to the i-th element of x 
array if i-th element of high array is higher than the previous element, otherwise assign i-th of low array to the 
i-th element of x array". The rule is: new if-else and w/?//e statements need single boolean value (not array) to 
decide which execution path should be taken. If you want to use them with arrays you have to iterate through 
bars using for loop (as shown above). 

On the other hand this can be implemented in single line using old-style array operations and IIF function: 

X = II f ( High > Ref ( High, -1 ), High, Low ); 

This works because IIF operates on ARRAYS as described in the tutorial. 


As you can see in many cases old-style AFL provides much more compact form. I always tried to explain this 
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advantage of AFL but only a few realised that. New control statements should be used where it is better to 
use them. As I tried to explain during last years in 80% of cases 'old-style' AFL provides the shortest formula. 
Only remaining 20% of cases needed script. Those 'script-only' cases now can be coded in native AFL thanks 
to new for/while/if-else statements. And this is correct usage of them - to replace script parts. 
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The local keyword declares local variable Inside user-defined function. Local variable Is the variable that Is 
visible/accessible only Inside the function. 

Due to the fact that AFL by default does not require to declare variables the decision whenever given variable 
Is treated as local or global Is taken depends on where It Is FIRST USED. 

You can however force AFL engine to require all variables to be declared using local or global keywords on 
formula-by-formula basis by placing SetOptlon("RequlreDeclaratlons", True ); at the top of the formula. 

If given Identifier appears first INSIDE function definition - then It Is treated as LOCAL variable. 

If given Identifier appears first OUTSIDE function definition - then It Is treated as GLOBAL variable. 

This default behaviour can be however overriden using global and local keywords (Introduced In 4.36) - see 
example 2. 

Example (commentary): 

k = 4 ; // this is GLOBAL variable 

function f( x ) 

{ 

z = 3; // this is LOCAL variable 

return z * x * k; // 'k' here references global variable k (first used above 
outside function) 

} 

z = 5; // this is GLOBAL variable with the same name as local variable in 
function f 

"The value of z before function call + WriteVal ( z ); 

// Now even if we call function 

// the value of our global variable z 

// is not affected by function call because 

// global variable z and local variable z are separate and 

// arguments are passed by value (not by reference) 

"The result of f( z ) = " + WriteVal ( f( z ) ) ; 

"The value of z after function call is unchanged : " + WriteVal ( z ); 

Example 2: Using local and global keywords to override default visibility rules: 

VariableA =5; // implict global variable 

function Test() 

{ 

local VariableA; // explicit local variable with the same identifier as 
global 
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global VariableB; // explicit global variable not defined earlier 

// may be used to return more than one value from the 

function 

VariableA = 99; 

VariableB = 333; 

} 

VariableB =1; // global variable 

"Before function call"; 

"VariableA = " + VariableA; 

"VariableB = " + VariableB; 

Test () ; 

"After function call"; 

"VariableA = " + VariableA + " (not affected by function call )"; 

"VariableB = " + VariableB + " (affected by the function call )" 
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procedure Keyword 

The procedure keyword begins definition of the user-procedure. 

Procedure is a function that does NOT return any value (does not have return statement). 
Consult function keyword help for more details. 
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return Keyword 

The return keyword allows to return the value from the function. 

function RiseToAPowerOf2( x ) 

{ 

return x 2 ; 

} 

At the end of the function we can see 'return' statement that Is used to return the result to the caller. Note that 
currently return statement must be placed at the very end of the function. 

Consult function keyword help for more details. 
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switch Statement 

The switch and case statements help control complex conditional and branching operations. The switch 
statement transfers control to a statement within its body. 

Syntax: 

switch ( expression) 

{ 

case constant-expression 1: statement; 
case constant-expression2 : statement; 

case constant-expressionN: statement; 

default : statement; 

} 

Control passes to the statement whose case constant-expression matches the value of switch ( expression ). 
The switch statement can include any number of case instances, but no two case constants within the same 
switch statement can have the same value. Execution of the statement body begins at the selected statement 
and proceeds until the end of the body or until a break statement transfers control out of the body. 

You can use the break statement to end processing of a particular case within the switch statement and to 
branch to the end of the switch statement. Without break, the program continues to the next case, executing 
the statements until a break or the end of the statement is reached. In some situations, this continuation may 
be desirable. 

The default statement is executed if no case constant-expression is equal to the value of switch ( expression 
). If the default statement is omitted, and no case match is found, none of the statements in the switch body 
are executed. There can be at most one default statement. The default statement, if exists, MUST come at the 
end. Otherwise it may be executed before hitting conditions defined below it. A case or default label is 
allowed to appear only inside a switch statement. 

The type of switch expression and case constant-expression can be any. The value of each case 
constant-expression must be unique within the statement body. Otherwise first-match will be used. 

Example: 

for ( n = 0; n < 10; n++ ) 

{ 

printf ( "Current n = %f\n", n ); 

switch (n) { 

case 0 : 

printf ("The number is zero.Xn"); 

break; 
case 3 : 
case 5 : 
case 7 : 
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printfC'n is a prime numberin''); 

break; 

case 2: printfC'n is a prime numberin''); 

case 4 : 
case 6 : 
case 8 : 

printfC'n is an even numberin''); 

break; 
case 1 : 
case 9 : 

printfC'n is a perfect squarein"); 

break; 
default : 

printfC'Only single-digit numbers are allowedin"); 

break; 

} 

More information can be found here: http://en.wikipedia.org/wiki/Switch_statement 
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while Keyword 

The while keyword is al part of while (described below) and do-while statements. 

while Statement 

The while statement lets you repeat a statement until a specified expression becomes false. 

Syntax 

while ( expression) statement 

The expression must have arithmetic (numeric/boolean) type. Execution proceeds as follows: 

1. The expression is evaluated. 

2. If expression is initially false, the body of the while statement is never executed, and control passes 
from the while statement to the next statement in the program. 

If expression is true (nonzero), the body of the statement is executed and the process is repeated 
beginning at step 1. 

This is an example of the while statement: 

i = 10; 

while ( i < 2 0 ) 

{ 

Plot ( MA ( Close, i ), "MA" + WriteVal ( i, 0 ), colorBlack +1); 
i = i + 1; 

} 

The example plots 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 - bar moving averages. 


AFL Function Reference - Alphabetical list of functions 

1. #include ( Miscellaneous functions) - preprocessor include command (AFL 2.2) 

2. #include_once ( Miscellaneous functions) - preprocessor include (once) command (AFL 2.70) 

3. #pragma ( Miscellaneous functions) - sets AFL pre-processor option (AFL 2.4) 

4. abs ( Math functions) - absolute value 

5. AccDist ( Indicators) - accumulation/distribution 

6. acos ( Math functions) - arccosine function 

7. AddColumn (Exploration / Indicators) - add numeric exploration column (AFL 1.8) 

8. AddRankColumn (Exploration / Indicators) - add ranking column(s) according to current sort set by 
SetSortColumns (AFL 5.70) 

9. AddRow (Exploration / Indicators) - add raw text row to exploration (AFL 4.0) 

10. AddSummaryRows (Exploration / Indicators) - add summary row(s) to the exploration output (AFL 
3.2) 

11 . AddTextColumn (Exploration / Indicators) - add text exploration column (AFL 1.8) 
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12. AddToComposite ( Composites) - add value to composite ticker (AFL 2.0) 

13. ADLine ( Composites) - advance/decline line (AFL 1.2) 

14. Advissues ( Composites) - advancing issues (AFL 1.2) 

15. AdvVolume ( Composites) - advancing issues volume (AFL 1.2) 

16. ADX ( Indicators) - average directional movement index (AFL 1.3) 

17. Alertif ( Trading system toolbox) - trigger alerts (AFL 2.1) 

18. AlmostEqual ( Math functions) - rounding error insensitive comparison (AFL 2.80) 

19. AMA ( Moving averages, summation) - adaptive moving average (AFL 1.5) 

20. AMA2 ( Moving averages, summation) - adaptive moving average (AFL 1.5) 

21. ApplyStop ( Trading system toolbox) - apply built-in stop (AFL 1.7) 

22. Asc ( String manipulation) - get ASCII code of character (AFL 2.80) 

23. asin ( Math functions) - arcsine function 

24. atari ( Math functions) - arc tan 

25. atan2 ( Math functions) - calculates arctangent of y/x (AFL 2.90) 

26. ATR (Indicators) - average true range (AFL 1.3) 

27. Barindex ( Date/Time) - get zero-based bar number (AFL 2.3) 

28. BarsSince ( Trading system toolbox) - bars since 

29. BBandBot (Indicators) - bottom bollinger band 

30. BBandTop (Indicators) - top bollinger band 

31. BeginValue ( Date/Time) - Value of the array at the begin of the range (AFL 2.3) 

32. CategoryAddSymbol (Information / Categories) - adds a symbol to a category (AFL 2.5) 

33. Category Create (Information / Categories) - add new category (such as watch list) (AFL 3.70) 

34. CategoryFind (Information / Categories) - search for category by name (AFL 3.0) 

35. CategoryGetName (Information / Categories) - get the name of a category (AFL 2.5) 

36. CategoryGetSymbols (Information / Categories) - retrieves comma-separated list of symbols 
belonging to given category (AFL 2.5) 

37. CategoryRemoveSymbol (Information / Categories) - remove a symbol from a category (AFL 2.5) 

38. CategorySetName (Information / Categories) - set the name of category (group, market, watch list, 
industry) (AFL 3.20) 

39. CCI (Indicators) - commodity channel index 

40. ceil ( Math functions) - ceil value 

41. Chaikin (Indicators) - chaikin oscillator 

42. ClipboardGet ( Miscellaneous functions) - retrieves current contents of Windows clipboard (AFL 
2.60) 

43. ClipboardSet ( Miscellaneous functions) - copies the text to the Windows clipboard (AFL 2.6) 

44. ColorBlend (Indicators) - blends (mixes) two colors (AFL 3.30) 

45. ColorHSB ( Miscellaneous functions) - specify color using Hue-Saturation-Brightness (AFL 2.80) 

46. ColorRGB ( Miscellaneous functions) - specify color using Red-Green-Blue components (AFL 2.80) 

47. Correlation ( Statistical functions) - correlation (AFL 1.4) 

48. cos ( Math functions) - cosine 

49. cosh ( Math functions) - hyperbolic cosine function (AFL 2.80) 

50. CreateObject ( Miscellaneous functions) - create COM object (AFL 1.8) 

51. CreateStaticObject ( Miscellaneous functions) - create static COM object (AFL 1.8) 

52. Cross ( Trading system toolbox) - crossover check 

53. Cum ( Moving averages, summation) - cumulative sum 

54. Date ( Date/Time) - date (AFL 1.1) 

55. DateNum ( Date/Time) - date number (AFL 1.4) 

56. DateTime ( Date/Time) - retrieves encoded date time (AFL 2.3) 

57. DateTimeAdd ( Date/Time) - adds specified number of seconds/minutes/hours/days to datetime (AFL 
3.40) 

58. DateTimeConvert ( Date/Time) - date/time format conversion (AFL 2.90) 

59. DateTimeDiff ( Date/Time) - get difference in seconds between two datetime values (AFL 3.30) 
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60. DateTimeToStr ( String manipulation) - convert datetime to string (AFL 2.8) 

61. Day ( Date/Time) - day of month (AFL 1.4) 

62. DayOfWeek ( Date/Time) - day of week (AFL 1.4) 

63. DayOfYear ( Date/Time) - get ordinal number of day in a year (AFL 2.4) 

64. DaysSince1900 ( Date/Time) - get number of days since January 1st, 1900 (AFL 3.20) 

65. Decissues ( Composites) - declining issues (AFL 1.2) 

66. DecVolume ( Composites) - declining issues volume (AFL 1.2) 

67. DEMA ( Moving averages, summation) - double exponential moving average (AFL 2.0) 

68. EMA ( Moving averages, summation) - exponential moving average 

69. EnableRotationalTrading ( Trading system toolbox) - Turns on rotational-trading mode of the 
backtester (AFL 2.5) 

70. EnableScript ( Miscellaneous functions) - enable scripting engine 

71. EnableTextOutput ( Miscellaneous functions) - allows to enable or disable text output (AFL 2.20) 

72. EncodeColor (Exploration / Indicators) - encodes color for indicator title (AFL 2.2) 

73. EndValue ( Date/Time) - value of the array at the end of the selected range (AFL 2.3) 

74. Equity ( Trading system toolbox) - calculate single-symbol equity line (AFL 2.0) 

75. Error ( Miscellaneous functions) - displays user-defined error message and stops the execution (AFL 
3.7) 

76. EXP ( Math functions) - exponential function 

77. ExRem ( Trading system toolbox) - remove excessive signals (AFL 1.5) 

78. ExRemSpan ( Trading system toolbox) - remove excessive signals spanning given number of bars 
(AFL 2.0) 

79. fclose (File Input/Output functions) - close a file (AFL 2.5) 

80. fdelete (File Input/Output functions) - deletes a file (AFL 2.70) 

81. fdir (File Input/Output functions) - list directory content (AFL 3.70) 

82. feof (File Input/Output functions) - test for end-of-file (AFL 2.5) 

83. FFT ( Basic price pattern detection) - performs Fast Fourier Transform (AFL 2.90) 

84. fgets (File Input/Output functions) - get a string from a file (AFL 2.5) 

85. fgetstatus (File Input/Output functions) - retrieves file status/properties (AFL 2.90) 

86. FIR ( Moving averages, summation) - Finite Impulse Response filter (AFL 3.40) 

87. FirstVisibleValue (Indicators) - get first visible value of array (AFL 3.40) 

88. Flip ( Trading system toolbox) - (AFL 1.5) 

89. floor ( Math functions) - floor value 

90. fmkdir (File Input/Output functions) - creates (makes) a directory (AFL 2.70) 

91. fopen (File Input/Output functions) - open a file (AFL 2.5) 

92. Foreign (Referencing other symbol data) - access foreign security data (AFL 1.5) 

93. fputs (File Input/Output functions) - write a string to a file (AFL 2.5) 

94. frac ( Math functions) - fractional part 

95. frmdir (File Input/Output functions) - removes a directory (AFL 2.70) 

96. FullName (Information / Categories) - full name of the symbol (AFL 1.1) 

97. GapDown ( Basic price pattern detection) - gap down 

98. GapUp ( Basic price pattern detection) - gap up 

99. GetAsyncKeyState ( Miscellaneous functions) - query the current state of keyboard keys (AFL 3.60) 

100. GetBacktesterObject ( Trading system toolbox) - get the access to backtester object (AFL 2.60) 

101. GetBaseIndex (Referencing other symbol data) - retrieves symbol of relative strength base index 
(AFL 2.1) 

102. GetCategorySymbols (Information / Categories) - retrieves comma-separated list of symbols 
belonging to given category (AFL 2.4) 

103. GetChartBkColor (Indicators) - get the RGB color value of chart background (AFL 3.20) 

104. GetChartID (Exploration / Indicators) - get current chart ID (AFL 2.3) 

105. GetCursorMouseButtons (Indicators) - get current state of mouse buttons (AFL 2.80) 

106. GetCursorXPosition (Indicators) - get current X position of mouse pointer (AFL 2.80) 
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107. GetCursorYPosition (Indicators) - get current Y position of mouse pointer (AFL 2.80) 

108. GetDatabaseName (Information / Categories) - retrieves foider name of current database (AFL 2.3) 

109. GetExtraData ( Misceiianeous functions) - get extra data from externai data source (AFL 1.9) 

110. GetFnData (Information / Categories) - get fundamentai data (AFL 2.90) 

111. GetFormulaPath ( Miscellaneous functions) - get file path of current formula (AFL 3.90) 

112. GetOption ( Trading system toolbox) - gets the value of option in automatic analysis settings (AFL 
2.60) 

113. GetPerformanceCounter ( Miscellaneous functions) - retrieves the current value of the 
high-resolution performance counter (AFL 2.90) 

114. GetPlaybackDateTime ( Date/Time) - get bar replay position date/time (AFL 3.0) 

115. GetPriceStyle (Exploration / Indicators) - get current price chart style (AFL 2.70) 

116. GetRTData ( Miscellaneous functions) - retrieves the real-time data fields (AFL 2.60) 

117. GetRTDataForeign ( Miscellaneous functions) - retrieves the real-time data fields (for specified 
symbol) (AFL 2.80) 

118. GetScriptObject ( Miscellaneous functions) - get access to script COM object (AFL 1.8) 

119. GetTradingInterface ( Trading system toolbox) - retrieves OLE automation object to automatic 
trading interfac (AFL 2.70) 

120. GfxArc (Low-level graphics) - draw an arc (AFL 3.0) 

121. GfxChord (Low-level graphics) - draw a chord (AFL 3.0) 

122. GfxCircle (Low-level graphics) - draw a circle (AFL 3.0) 

123. GfxDrawText (Low-level graphics) - draw a text (clipped to rectangle) (AFL 3.0) 

124. GfxEllipse (Low-level graphics) - draw an ellipse (AFL 3.0) 

125. GfxGetTextWidth (Low-level graphics) - get pixel width of text (AFL 2.80) 

126. GfxGradientRect (Low-level graphics) - draw a rectangle with gradient fill (AFL 3.0) 

127. GfxLineTo (Low-level graphics) - draw a line to specified point (AFL 3.0) 

128. GfxMoveTo (Low-level graphics) - move graphic cursor to new position (AFL 3.0) 

129. GfxPie (Low-level graphics) - draw a pie (AFL 3.0) 

130. GfxPolygon (Low-level graphics) - draw a polygon (AFL 3.0) 

131. GfxPolyline (Low-level graphics) - draw a polyline (AFL 3.0) 

132. GfxRectangle (Low-level graphics) - draw a rectangle (AFL 3.0) 

133. GfxRoundRect (Low-level graphics) - draw a rectangle with rounded corners (AFL 3.0) 

134. GfxSelectFont (Low-level graphics) - create / select graphic font (AFL 3.0) 

135. GfxSelectHatchBrush (Low-level graphics) - select hatch style brush (AFL 4.0) 

136. GfxSelectPen (Low-level graphics) - create / select graphic pen (AFL 3.0) 

137. GfxSelectSolidBrush (Low-level graphics) - create / select graphic brush (AFL 3.0) 

138. GfxSetBkColor (Low-level graphics) - set graphic background color (AFL 3.0) 

139. GfxSetBkMode (Low-level graphics) - set graphic background mode (AFL 3.0) 

140. GfxSetCoordsMode (Low-level graphics) - set low-level graphics co-ordinate mode (AFL 2.80) 

141 . GfxSetOverlayMode (Low-level graphics) - set low-level graphic overlay mode (AFL 3.0) 

142. GfxSetPixel (Low-level graphics) - set pixel at specified position to specified color (AFL 3.0) 

143. GfxSetTextAlign (Low-level graphics) - set text alignment (AFL 3.0) 

144. GfxSetTextColor (Low-level graphics) - set graphic text color (AFL 3.0) 

145. GfxSetZOrder (Low-level graphics) - set current low-level graphic Z-order layer (AFL 2.80) 

146. GfxTextOut (Low-level graphics) - writes text at the specified location (AFL 3.0) 

147. GicsID ( Information / Categories) - get GIGS category information (AFL 3.40) 

148. GroupID (Information / Categories) - get group ID/name (AFL 1.8) 

149. HHV ( Lowest/Highest) - highest high value 

150. HHVBars ( Lowest/Highest) - bars since highest high 

151. Highest ( Lowest/FIigbest) - highest value 

152. HighestBars ( Lowest/Flighest) - bars since highest value 

153. HighestSince ( Lowest/Highest) - highest value since condition met (AFL 1.4) 

154. HighestSinceBars ( Lowest/Highest) - bars since highest value since condition met (AFL 1.4) 
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155. HighestVisibleValue (Indicators) - get the highest vaiue within visibie chart area (AFL 3.30) 

156. HMA ( Moving averages, summation) - Huii Moving Average (AFL 3.40) 

157. Hold ( Trading system tooibox) - hoid the aiert signai 

158. Hour ( Date/Time) - get current bar's hour (AFL 2.0) 

159. IcbID (Information / Categories) - get ICB category information (AFL 3.60) 

160. Ilf ( Trading system tooibox) - immediate IF function 

161. MR ( Moving averages, summation) - infinite impulse response filter (AFL 4.0) 

162. IndustrylD ( Information / Categories) - get industry ID / name (AFL 1.8) 

163. InGICS (Information / Categories) - test GICS membership (AFL 3.40) 

164. InICB (Information / Categories) - test ICB membership (AFL 3.60) 

165. Inside ( Basic price pattern detection) - inside day 

166. Int ( Math functions) - integer part 

167. Interval ( Date/Time) - get bar interval (in seconds) (AFL 2.1) 

168. InWatchList (Information / Categories) - watch list membership test (by ordinal number) 

169. InWatchListName (Information / Categories) - watch list membership test (by name) (AFL 3.0) 

170. IsContinuous (Information / Categories) - checks 'continuous quotations' flag state (AFL 2.60) 

171 . IsEmpty ( Miscellaneous functions) - empty value check (AFL 1.5) 

172. IsFavorite (Information / Categories) - check if current symbol belongs to favorites (AFL 2.5) 

173. IsFinite ( Miscellaneous functions) - check if value is not infinite (AFL 2.3) 

174. Isindex (Information / Categories) - check if current symbol is an index (AFL 2.5) 

175. IsNan ( Miscellaneous functions) - checks for NaN (not a number) (AFL 2.3) 

176. IsNull ( Miscellaneous functions) - check for Null (empty) value (AFL 2.3) 

177. IsTrue ( Miscellaneous functions) - true value (non-empty and non-zero) check (AFL 1.5) 

178. LastValue ( Trading system toolbox) - last value of the array 

179. LastVisibleValue (Indicators) - get last visible value of array (AFL 3.40) 

180. LineArray (Exploration / Indicators) - generate trend-line array (AFL 2.5) 

181. LinearReg ( Statistical functions) - linear regression end-point (AFL 2.2) 

182. LinRegIntercept ( Statistical functions) - (AFL 2.2) 

183. LinRegSlope ( Statistical functions) - linear regression slope (AFL 1.4) 

184. LLV ( Lowest/Highest) - lowest low value 

185. LLVBars ( Lowest/Highest) - bars since lowest low 

186. log ( Math functions) - natural logarithm 

187. loglO ( Math functions) - decimal logarithm 

188. Lookup ( Date/Time) - search the array for bar with specified date/time (AFL 3.40) 

189. Lowest ( Lowest/Flighest) - lowest value 

190. LowestBars ( Lowest/Flighest) - bars since lowest 

191 . LowestSince ( Lowest/Highest) - lowest value since condition met (AFL 1.4) 

192. LowestSinceBars ( Lowest/Highest) - barssince lowest value since condition met (AFL 1.4) 

193. LowestVisibleValue (Indicators) - get the lowest value within visible chart area (AFL 3.30) 

194. MA ( Moving averages, summation) - simple moving average 

195. MACD ( Indicators) - moving average convergence/divergence 

196. MarketID (Information / Categories) - market ID / name (AFL 1.8) 

197. Matrix (Matrix functions) - create a new matrix (AFL 4.0) 

198. Max ( Math functions) - maximum value of two numbers / arrays 

199. MDI ( Indicators) - minus directional movement indicator (-DI) (AFL 1.3) 

200. Median ( Statistical functions) - calculate median (middle element) (AFL 2.5) 

201. MFi (Indicators) - money flow index 

202. MicroSec ( Date/Time) - get bar's microsecond part of the timestamp 

203. MiiliSec ( Date/Time) - get bar's millisecond part of the timestamp 

204. Min ( Math functions) - minimum value of two numbers / arrays 

205. Minute ( Date/Time) - get current bar's minute (AFL 2.0) 

206. Month ( Date/Time) - month (AFL 1.4) 
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207. mtRandom ( Statistical functions) - Mersene Twister random number generator (AFL 3.0) 

208. mtRandomA ( Statistical functions) - Mersene Twister random number generator (array version) (AFL 
3.0) 

209. MxGetSize (Matrix functions) - get size of the matrix (AFL 4.0) 

210. Mxidentity (Matrix functions) - create an identity matrix (AFL 4.0) 

211. MxTranspose (Matrix functions) - creates transpose of an input matrix (AFL 4.0) 

212. Name (Information / Categories) - ticker symbol (AFL 1.1) 

213. NoteGet ( Miscellaneous functions) - retrieves the text of the note (AFL 2.6) 

214. NoteSet ( Miscellaneous functions) - sets text of the note (AFL 2.6) 

215. Now ( Date/Time) - gets current system date/time (AFL 2.3) 

216. NullCount ( Miscellaneous functions) - count consecutive Null values (AFL 3.90) 

217. NumToStr ( String manipulation) - convert number to string (AFL 2.5) 

218. NVI (Indicators) - negative volume index 

219. Nz ( Miscellaneous functions) - Null (Null/Nan/Infinity) to zero (AFL 2.3) 

220. OBV ( Indicators) - on balance volume 

221. Optimize ( Trading system toolbox) - define optimization variable (AFL 1.7) 

222. OptimizerSetEngine ( Trading system toolbox) - select external optimization engine (AFL 3.20) 

223. OptimizerSetOption ( Trading system toolbox) - set the value of external optimizer engine parameter 
(AFL 3.20) 

224. OscP (Indicators) - price oscillator 

225. OscV (Indicators) - volume oscillator 

226. Outside ( Basic price pattern detection) - outside bar 

227. Param (Exploration / Indicators) - add user user-definable numeric parameter (AFL 2.3) 

228. ParamCoior (Exploration / Indicators) - add user user-definable color parameter (AFL 2.3) 

229. ParamDate (Exploration / Indicators) - add user user-definable date parameter (AFL 2.60) 

230. ParamFieid (Exploration / Indicators) - creates price field parameter (AFL 2.70) 

231. ParamList (Exploration / Indicators) - creates the parameter that consist of the list of choices (AFL 
2.70) 

232. ParamStr (Exploration / Indicators) - add user user-definable string parameter (AFL 2.3) 

233. ParamStyle (Exploration / Indicators) - select styles applied to the plot (AFL 2.70) 

234. ParamTime (Exploration / Indicators) - add user user-definable time parameter (AFL 2.60) 

235. ParamToggle (Exploration / Indicators) - create Yes/No parameter (AFL 2.70) 

236. ParamTrigger (Exploration / Indicators) - creates a trigger (button) in the parameter dialog (AFL 2.70) 

237. PDI (Indicators) - plus directional movement indicator (AFL 1.3) 

238. Peak ( Basic price pattern detection) - peak (AFL 1.1) 

239. PeakBars ( Basic price pattern detection) - bars since peak (AFL 1.1) 

240. Percentile ( Statistical functions) - calculate percentile (AFL 2.5) 

241. PercentRank (Indicators) - calculate percent rank (AFL 3.40) 

242. PlaySound ( Miscellaneous functions) - play back specified .WAV file (AFL 3.40) 

243. Plot (Exploration / Indicators) - plot indicator graph (AFL 1.8) 

244. PlotForeign (Referencing other symbol data) - plot foreign security data (AFL 2.2) 

245. PlotGrid (Exploration / Indicators) - Plot horizontal grid line (AFL 2.3) 

246. PlotOHLC (Exploration / Indicators) - plot custom OHLC chart (AFL 2.2) 

247. PlotShapes (Exploration / Indicators) - plots arrows and other shapes (AFL 2.3) 

248. PlotText ( Indicators) - write text on the chart (AFL 2.80) 

249. PlotTextSetFont ( Basic price pattern detection) - write text on the chart with user-defined font (AFL 
2.80) 

250. PlotVAPOverlay (Exploration / Indicators) - plot Volume-At-Price overlay chart (AFL 2.4) 

251. PlotVAPOverlayA (Indicators) - plot multiple-segment Volume-At-Price chart (AFL 3.20) 

252. PopupWindow ( Miscellaneous functions) - display pop-up window (AFL 3.0) 

253. Prec ( Math functions) - adjust number of decimal points of floating point number 

254. Prefs ( Miscellaneous functions) - retrieve preferences settings (AFL 1.4) 
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255. printf ( String manipulation) - Print formatted output to the output window. (AFL 2.5) 

256. PVI ( Indicators) - positive volume index 

257. Random ( Statistical functions) - random number (AFL 1.9) 

258. Ref ( Trading system toolbox) - reference past/future values of the array 

259. RelStrength (Referencing other symbol data) - comparative relative strength (AFL 1.3) 

260. RequestTimedRefresh (Indicators) - forces periodical refresh of indicator pane (AFL 2.90) 

261. RestorePriceArrays (Referencing other symbol data) - restore price arrays to original symbol (AFL 
2.5) 

262. Reverse ( Miscellaneous functions) - reverse the order of the elements in the array (AFL 3.90) 

263. RMI ( Indicators) - Relative Momentum Index (AFL 2.1) 

264. ROC (Indicators) - percentage rate of change 

265. Round ( Math functions) - round number to nearest integer 

266. RSI (Indicators) - relative strength index 

267. RWI ( Indicators) - random walk index 

268. RWlHi (Indicators) - random walk index of highs 

269. RWILo (Indicators) - random walk index of lows 

270. SAR ( Indicators) - parabolic stop-and-reverse (AFL 1.3) 

271. Say ( Miscellaneous functions) - speaks provided text (AFL 2.90) 

272. Second ( Date/Time) - get current bar's second (AFL 2.0) 

273. SectorlD ( Information / Categories) - get sector ID / name (AFL 1.8) 

274. SelectedValue (Exploration / Indicators) - retrieves value of the array at currently selected date/time 
point (AFL 2.1) 

275. SendEmail ( Miscellaneous functions) - send an e-mail message (AFL 3.90) 

276. SetBacktestMode ( Trading system toolbox) - Sets working mode of the backtester (AFL 3.0) 

277. SetBarFillColor (Indicators) - set bar/candlestick/cloud chart fill color (AFL 3.1) 

278. SetBarsRequired ( Miscellaneous functions) - set number of previous and future bars needed for 
script/DLL to properly execute (AFL 2.1) 

279. SetChartBkColor (Indicators) - set background color of a chart (AFL 2.80) 

280. SetChartBkGradientFill (Indicators) - enables background gradient color fill in indicators (AFL 2.90) 

281. SetChartOptions (Exploration / Indicators) - set/clear/overwrite defaults for chart pane options (AFL 
2.70) 

282. SetCustomBacktestProc ( Trading system toolbox) - define custom backtest procedure formula file 
(AFL 2.70) 

283. SetForeign (Referencing other symbol data) - replace current price arrays with those of foreign 
security (AFL 2.5) 

284. SetFormulaName ( Trading system toolbox) - set the name of the formula (AFL 2.5) 

285. SetGradientFill (Indicators) - set the colors of a gradient fill plot (AFL 3.60) 

286. SetOption ( Trading system toolbox) - sets options in automatic analysis settings (AFL 2.3) 

287. SetPositionSize ( Trading system toolbox) - set trade size (AFL 2.70) 

288. SetSortColumns (Exploration / Indicators) - sets the columns which will be used for sorting in AA 
window (AFL 2.90) 

289. SetStopPrecedence ( Trading system toolbox) - set precedence of built-in stops (AFL 4.0) 

290. SetTradeDelays ( Trading system toolbox) - allows to control trade delays applied by the backtester 
(AFL 2.1) 

291. ShellExecute ( Basic price pattern detection) - execute a file (AFL 3.40) 

292. sign ( Math functions) - returns the sign of the number/array (AFL 2.50) 

293. Signal (Indicators) - macd signal line 

294. sin ( Math functions) - sine function 

295. sinh ( Math functions) - hyperbolic sine function (AFL 2.80) 

296. Sort ( Miscellaneous functions) - performs a quick sort of the array (AFL 3.90) 

297. SparseCompress ( Miscellaneous functions) - compress sparse array (AFL 4.0) 

298. SparseExpand ( Miscellaneous functions) - expand compressed array to sparse array (AFL 4.0) 
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299. sqrt ( Math functions) - square root 

300. StaticVarCompareExchange ( Miscellaneous functions) - atomic interlocked static variable 
compare-exchange operation (AFL 3.50) 

301. StaticVarCount ( Miscellaneous functions) - get the total number of static variables in memory (AFL 
3.30) 

302. StaticVarGenerateRanks ( Miscellaneous functions) - generate ranking of multiple symbols and 
store it to static variables (AFL 3.70) 

303. StaticVarGet ( Miscellaneous functions) - gets the value of static variable (AFL 2.60) 

304. StaticVarGetRankedSymbols ( Miscellaneous functions) - retrieve a list of ranked symbols from 
static variables (AFL 3.70) 

305. StaticVarGetText ( Miscellaneous functions) - gets the value of static variable as string (AFL 2.60) 

306. StaticVarInfo ( Miscellaneous functions) - get the information about static variable(s) (AFL 3.60) 

307. StaticVarRemove ( Miscellaneous functions) - remove static variable (AFL 2.80) 

308. StaticVarSet ( Miscellaneous functions) - sets the value of static variable (AFL 2.60) 

309. StaticVarSetText ( Miscellaneous functions) - Sets the value of static string variable. (AFL 2.60) 

310. Status ( Miscellaneous functions) - get run-time AFL status information (AFL 1.65) 

311. StdErr ( Statistical functions) - standard error (AFL 1.4) 

312. StDev ( Statistical functions) - standard deviation (AFL 1.4) 

313. StochD (Indicators) - stochastic slow %D 

314. StochK (Indicators) - stochastic slow %K 

315. StrCount ( String manipulation) - count the occurrences of substring within a string (AFL 3.20) 

316. StrExtract ( String manipulation) - extracts given item (substring) from comma-separated string (AFL 
2.4) 

317. StrFind ( String manipulation) - find substring in a string (AFL 2.5) 

318. StrFormat ( String manipulation) - Write formatted output to the string (AFL 2.5) 

319. StrLeft ( String manipulation) - extracts the leftmost part (AFL 2.0) 

320. StrLen ( String manipulation) - string length (AFL 1.5) 

321. StrMatch ( String manipulation) - string pattern/wildcard matching (AFL 4.0) 

322. StrMid ( String manipulation) - extracts part of the string (AFL 2.0) 

323. StrReplace ( String manipulation) - string replace (AFL 2.90) 

324. StrRight ( String manipulation) - extracts the rightmost part of the string (AFL 2.0) 

325. StrSort ( String manipulation) - sort comma-separated item list (AFL 3.90) 

326. StrToDateTime ( String manipulation) - convert string to datetime (AFL 2.80) 

327. StrToLower ( String manipulation) - convert to lowercase (AFL 2.80) 

328. StrToNum ( String manipulation) - convert string to number (AFL 2.5) 

329. StrToUpper ( String manipulation) - convert to uppercase (AFL 2.80) 

330. StrTrim ( String manipulation) - trim whitespaces from the string (AFL 3.90) 

331. Study ( Miscellaneous functions) - reference hand-drawn study (AFL 1.5) 

332. Sum ( Moving averages, summation) - sum data over specified number of bars 

333. tan ( Math functions) - tangent function (AFL 1.0) 

334. tanh ( Math functions) - hyperbolic tangent function (AFL 2.80) 

335. TEMA ( Moving averages, summation) - triple exponential moving average (AFL 2.0) 

336. ThreadSleep ( Miscellaneous functions) - suspend thread for specified number of milliseconds (AFL 
3.50) 

337. TimeFrameCompress (Time Frame functions) - compress single array to given time frame (AFL 2.5) 

338. TimeFrameExpand (Time Frame functions) - expand time frame compressed array (AFL 2.5) 

339. TimeFrameGetPrice (Time Frame functions) - retrieve O, FI, L, C, V values from other time frame 
(AFL 2.5) 

340. TimeFrameMode (Time Frame functions) - switch time frame compression mode (AFL 2.80) 

341. TimeFrameRestore (Time Frame functions) - restores price arrays to original time frame (AFL 2.5) 

342. TimeFrameSet (Time Frame functions) - switch price arrays to a different time frame (AFL 2.5) 

343. TimeNum ( Date/Time) - get current bar time (AFL 2.0) 


AFL Function Reference - Alphabetical list of functions 


548 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


344. Trin ( Composites) - traders (Arms) index (AFL 1.2) 

345. TRIX (Indicators) - tripie exponentiai smoothed price 

346. Trough ( Basic price pattern detection) - trough (AFL 1.1) 

347. TroughBars ( Basic price pattern detection) - bars since trough (AFL 1.1) 

348. TSF ( Statisticai functions) - time series forecast (AFL 2.2) 

349. Ultimate (Indicators) - uitimate osciilator 

350. Uncissues ( Composites) - unchanged issues (AFL 1.2) 

351. UncVolume ( Composites) - unchaged issues volume (AFL 1.2) 

352. ValueWhen ( Trading system toolbox) - get value of the array when condition met (AFL 1.1) 

353. VarGet ( Miscellaneous functions) - gets the value of dynamic variable (AFL 2.60) 

354. VarGetText ( Miscellaneous functions) - gets the text value of dynamic variable (AFL 2.80) 

355. VarSet ( Miscellaneous functions) - sets the value of dynamic variable (AFL 2.60) 

356. VarSetText ( Miscellaneous functions) - sets dynamic variable of string type (AFL 2.80) 

357. Version ( Miscellaneous functions) - get version info (AFL 1.9) 

358. Wilders ( Moving averages, summation) - Wilder's smoothing (AFL 1.4) 

359. WMA ( Moving averages, summation) - weighted moving average (AFL 2.0) 

360. Writelf (Exploration / Indicators) - commentary conditional text output 

361. WriteVal (Exploration / Indicators) - converts number to string 

362. XYChartAddPoint (Exploration / Indicators) - add point to exploration scatter (XY) chart (AFL 3.60) 

363. XYChartSetAxis (Exploration / Indicators) - set the names of X and Y axes in exploration scatter 
charts (AFL 3.60) 

364. Year ( Date/Time) - year (AFL 1.4) 

365. ZIG ( Basic price pattern detection) - zig-zag indicator (AFL 1.1) 

366. _DEFAULT_NAME (Exploration / Indicators) - retrive default name of the plot (AFL 2.70) 

367. _DT ( Date/Time) - convert string to datetime (AFL 3.40) 

368. _N (Exploration / Indicators) - no text output (AFL 2.1) 

369. _PARAM_VALUES (Exploration / Indicators) - retrieve param values string (AFL 2.70) 

370. _SECTION_BEGIN (Exploration / Indicators) - section begin marker (AFL 2.70) 

371. _SECTION_END (Exploration / Indicators) - section end marker (AFL 2.70) 

372. _SECTION_NAME (Exploration / Indicators) - retrieve current section name (AFL 2.70) 

373. _TRACE ( Miscellaneous functions) - print text to system debug viewer (AFL 2.4) 

374. _TRACEF ( Miscellaneous functions) - print formatted text to system debug viewer (AFL 4.0) 

AFL Function Reference - Categorized list of functions 

Basic price pattern detection 

• FFT - performs Fast Fourier Transform (AFL 2.90) 

• GapDown - gap down 

• GapUp - gap up 

• inside - inside day 

• Outside - outside bar 

• Peak - peak (AFL 1.1) 

• PeakBars - bars since peak (AFL 1.1) 

• PiotTextSetFont - write text on the chart with user-defined font (AFL 2.80) 

• SheiiExecute - execute a file (AFL 3.40) 

• Trough - trough (AFL 1.1) 

• TroughBars - bars since trough (AFL 1.1) 

• ZiG - zig-zag indicator (AFL 1.1) 

Composites 
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• AddToComposite - add value to composite ticker (AFL 2.0) 

• ADLine - advance/decline line (AFL 1.2) 

• Advissues - advancing issues (AFL 1.2) 

• AdvVolume - advancing issues volume (AFL 1.2) 

• Decissues - declining issues (AFL 1.2) 

• DecVolume - declining issues volume (AFL 1.2) 

• Trin - traders (Arms) index (AFL 1.2) 

• Uncissues - unchanged issues (AFL 1.2) 

• UncVolume - unchaged issues volume (AFL 1.2) 

Date/Time 

• Barindex - get zero-based bar number (AFL 2.3) 

• BeginValue - Value of the array at the begin of the range (AFL 2.3) 

• Date - date (AFL 1.1) 

• DateNum - date number (AFL 1.4) 

• DateTime - retrieves encoded date time (AFL 2.3) 

• DateTimeAdd - adds specified number of seconds/minutes/hours/days to datetime (AFL 3.40) 

• DateTimeConvert - date/time format conversion (AFL 2.90) 

• DateTimeDiff - get difference in seconds between two datetime values (AFL 3.30) 

• Day - day of month (AFL 1.4) 

• DayOfWeek - day of week (AFL 1.4) 

• DayOfYear - get ordinal number of day in a year (AFL 2.4) 

• DaysSince1900 - get number of days since January 1st, 1900 (AFL 3.20) 

• EndValue - value of the array at the end of the selected range (AFL 2.3) 

• GetPlaybackDateTime - get bar replay position date/time (AFL 3.0) 

• Hour - get current bar's hour (AFL 2.0) 

• Interval - get bar interval (in seconds) (AFL 2.1) 

• Lookup - search the array for bar with specified date/time (AFL 3.40) 

• MIcroSec - get bar's microsecond part of the timestamp 

• MllliSec - get bar's millisecond part of the timestamp 

• Minute - get current bar's minute (AFL 2.0) 

• Month - month (AFL 1.4) 

• Now - gets current system date/time (AFL 2.3) 

• Second - get current bar's second (AFL 2.0) 

• TImeNum - get current bar time (AFL 2.0) 

• Year - year (AFL 1.4) 

• _DT - convert string to datetime (AFL 3.40) 

Indicators 

• AccDlst - accumulation/distribution 

• ADX - average directional movement index (AFL 1.3) 

• ATR - average true range (AFL 1.3) 

• BBandBot - bottom bollinger band 

• BBandTop - top bollinger band 

• CCI - commodity channel index 

• Chaikin - chaikin oscillator 

• ColorBlend - blends (mixes) two colors (AFL 3.30) 

• FirstVisibleValue - get first visible value of array (AFL 3.40) 

• GetChartBkColor - get the RGB color value of chart background (AFL 3.20) 

• GetCursorMouseButtons - get current state of mouse buttons (AFL 2.80) 
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• GetCursorXPosition - get current X position of mouse pointer (AFL 2.80) 

• GetCursorYPosition - get current Y position of mouse pointer (AFL 2.80) 

• HighestVisibleValue - get the highest vaiue within visibie chart area (AFL 3.30) 

• LastVisibleValue - get iast visibie vaiue of array (AFL 3.40) 

• LowestVisibleValue - get the lowest value within visible chart area (AFL 3.30) 

• MACD - moving average convergence/divergence 

• MDI - minus directional movement indicator (-DI) (AFL 1.3) 

• MFI - money flow index 

• NVI - negative volume index 

• OBV - on balance volume 

• OscP - price oscillator 

• OscV - volume oscillator 

• PDI - plus directional movement indicator (AFL 1.3) 

• PercentRank - calculate percent rank (AFL 3.40) 

• PlotText - write text on the chart (AFL 2.80) 

• PlotVAPOverlayA - plot multiple-segment Volume-At-Price chart (AFL 3.20) 

• PVI - positive volume index 

• RequestTimedRefresh - forces periodical refresh of indicator pane (AFL 2.90) 

• RMI - Relative Momentum Index (AFL 2.1) 

• ROC - percentage rate of change 

• RSI - relative strength index 

• RWI - random walk index 

• RWlHi - random walk index of highs 

• RWILo - random walk index of lows 

• SAR - parabolic stop-and-reverse (AFL 1.3) 

• SetBarFillColor - set bar/candlestick/cloud chart fill color (AFL 3.1) 

• SetChartBkColor - set background color of a chart (AFL 2.80) 

• SetChartBkGradientFill - enables background gradient color fill in indicators (AFL 2.90) 

• SetGradientFill - set the colors of a gradient fill plot (AFL 3.60) 

• Signal - macd signal line 

• StochD - stochastic slow %D 

• StochK - stochastic slow %K 

• TRIX - triple exponential smoothed price 

• Ultimate - ultimate oscillator 

Information / Categories 

• CategoryAddSymbol - adds a symbol to a category (AFL 2.5) 

• Category Create - add new category (such as watch list) (AFL 3.70) 

• CategoryFind - search for category by name (AFL 3.0) 

• CategoryGetName - get the name of a category (AFL 2.5) 

• CategoryGetSymbols - retrieves comma-separated list of symbols belonging to given category (AFL 
2.5) 

• CategoryRemoveSymbol - remove a symbol from a category (AFL 2.5) 

• CategorySetName - set the name of category (group, market, watch list, industry) (AFL 3.20) 

• FullName - full name of the symbol (AFL 1.1) 

• GetCategorySymbols - retrieves comma-separated list of symbols belonging to given category (AFL 
2.4) 

• GetDatabaseName - retrieves folder name of current database (AFL 2.3) 

• GetFnData - get fundamental data (AFL 2.90) 

• GicsID - get GIGS category information (AFL 3.40) 

• GroupID - get group ID/name (AFL 1.8) 
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• IcbID - get ICB category information (AFL 3.60) 

• IndustrylD - get industry ID / name (AFL 1.8) 

• InGICS - test GIGS membership (AFL 3.40) 

• InICB - test ICB membership (AFL 3.60) 

• InWatchList - watch list membership test (by ordinal number) 

• InWatchListName - watch list membership test (by name) (AFL 3.0) 

• IsContinuous - checks 'continuous quotations' flag state (AFL 2.60) 

• IsFavorite - check if current symbol belongs to favorites (AFL 2.5) 

• Isindex - check if current symbol is an index (AFL 2.5) 

• MarketID - market ID / name (AFL 1.8) 

• Name - ticker symbol (AFL 1.1) 

• SectorlD - get sector ID / name (AFL 1.8) 

Lowest/Highest 

• HHV - highest high value 

• HHVBars - bars since highest high 

• Highest - highest value 

• HighestBars - bars since highest value 

• HighestSince - highest value since condition met (AFL 1.4) 

• HighestSinceBars - bars since highest value since condition met (AFL 1.4) 

• LLV - lowest low value 

• LLVBars - bars since lowest low 

• Lowest - lowest value 

• LowestBars - bars since lowest 

• LowestSince - lowest value since condition met (AFL 1.4) 

• LowestSinceBars - barssince lowest value since condition met (AFL 1.4) 

Math functions 

• abs - absolute value 

• acos - arccosine function 

• AimostEquai - rounding error insensitive comparison (AFL 2.80) 

• asin - arcsine function 

• atan - arc tan 

• atan2 - calculates arctangent of y/x (AFL 2.90) 

• ceii - ceil value 

• cos - cosine 

• cosh - hyperbolic cosine function (AFL 2.80) 

• EXP - exponential function 

• fioor - floor value 

• frac - fractional part 

• int - integer part 

• iog - natural logarithm 

• ioglO - decimal logarithm 

• Max - maximum value of two numbers / arrays 

• Min - minimum value of two numbers / arrays 

• Prec - adjust number of decimal points of floating point number 

• Round - round number to nearest integer 

• sign - returns the sign of the number/array (AFL 2.50) 

• sin - sine function 

• sinh - hyperbolic sine function (AFL 2.80) 
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• sqrt - square root 

• tan - tangent function (AFL 1.0) 

• tanh - hyperbolic tangent function (AFL 2.80) 

Miscellaneous functions 

• #include - preprocessor include command (AFL 2.2) 

• #include_once - preprocessor include (once) command (AFL 2.70) 

• #pragma - sets AFL pre-processor option (AFL 2.4) 

• ClipboardGet - retrieves current contents of Windows clipboard (AFL 2.60) 

• ClipboardSet - copies the text to the Windows clipboard (AFL 2.6) 

• ColorHSB - specify color using Hue-Saturation-Brightness (AFL 2.80) 

• ColorRGB - specify color using Red-Green-Blue components (AFL 2.80) 

• CreateObject - create COM object (AFL 1.8) 

• CreateStaticObject - create static COM object (AFL 1.8) 

• EnableScript - enable scripting engine 

• EnableTextOutput - allows to enable or disable text output (AFL 2.20) 

• Error - displays user-defined error message and stops the execution (AFL 3.7) 

• GetAsyncKeyState - query the current state of keyboard keys (AFL 3.60) 

• GetExtraData - get extra data from external data source (AFL 1.9) 

• GetFormulaPath - get file path of current formula (AFL 3.90) 

• GetPerformanceCounter - retrieves the current value of the high-resolution performance counter 
(AFL 2.90) 

• GetRTData - retrieves the real-time data fields (AFL 2.60) 

• GetRTDataForeIgn - retrieves the real-time data fields (for specified symbol) (AFL 2.80) 

• GetScriptObject - get access to script COM object (AFL 1.8) 

• IsEmpty - empty value check (AFL 1.5) 

• IsFinite - check if value is not infinite (AFL 2.3) 

• IsNan - checks for NaN (not a number) (AFL 2.3) 

• IsNull - check for Null (empty) value (AFL 2.3) 

• IsTrue - true value (non-empty and non-zero) check (AFL 1.5) 

• NoteGet - retrieves the text of the note (AFL 2.6) 

• NoteSet - sets text of the note (AFL 2.6) 

• NullCount - count consecutive Null values (AFL 3.90) 

• Nz - Null (Null/Nan/Infinity) to zero (AFL 2.3) 

• PlaySound - play back specified .WAV file (AFL 3.40) 

• PopupWindow - display pop-up window (AFL 3.0) 

• Prefs - retrieve preferences settings (AFL 1.4) 

• Reverse - reverse the order of the elements in the array (AFL 3.90) 

• Say - speaks provided text (AFL 2.90) 

• SendEmail - send an e-mail message (AFL 3.90) 

• SetBarsRequired - set number of previous and future bars needed for script/DLL to properly execute 
(AFL 2.1) 

• Sort - performs a quick sort of the array (AFL 3.90) 

• SparseCompress - compress sparse array (AFL 4.0) 

• SparseExpand - expand compressed array to sparse array (AFL 4.0) 

• StaticVarCompareExchange - atomic interlocked static variable compare-exchange operation (AFL 
3.50) 

• StaticVarCount - get the total number of static variables in memory (AFL 3.30) 

• StaticVarGenerateRanks - generate ranking of multiple symbols and store it to static variables (AFL 
3.70) 

• StaticVarGet - gets the value of static variable (AFL 2.60) 
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• StaticVarGetRankedSymbols - retrieve a list of ranked symbols from static variables (AFL 3.70) 

• StaticVarGetText - gets the value of static variable as string (AFL 2.60) 

• StaticVarInfo - get the information about static variable(s) (AFL 3.60) 

• StaticVarRemove - remove static variable (AFL 2.80) 

• StaticVarSet - sets the value of static variable (AFL 2.60) 

• StaticVarSetText - Sets the value of static string variable. (AFL 2.60) 

• Status - get run-time AFL status information (AFL 1.65) 

• Study - reference hand-drawn study (AFL 1.5) 

• ThreadSleep - suspend thread for specified number of milliseconds (AFL 3.50) 

• VarGet - gets the value of dynamic variable (AFL 2.60) 

• VarGetText - gets the text value of dynamic variable (AFL 2.80) 

• VarSet - sets the value of dynamic variable (AFL 2.60) 

• VarSetText - sets dynamic variable of string type (AFL 2.80) 

• Version - get version info (AFL 1.9) 

• _TRACE - print text to system debug viewer (AFL 2.4) 

• _TRACEF - print formatted text to system debug viewer (AFL 4.0) 

Moving averages, summation 

• AMA - adaptive moving average (AFL 1.5) 

• AMA2 - adaptive moving average (AFL 1.5) 

• Cum - cumulative sum 

• DEMA - double exponential moving average (AFL 2.0) 

• EMA - exponential moving average 

• FiR - Finite Impulse Response filter (AFL 3.40) 

• HMA - Hull Moving Average (AFL 3.40) 

• iiR - infinite impulse response filter (AFL 4.0) 

• MA - simple moving average 

• Sum - sum data over specified number of bars 

• TEMA - triple exponential moving average (AFL 2.0) 

• Wiiders - Wilder's smoothing (AFL 1.4) 

• WMA - weighted moving average (AFL 2.0) 

Statistical functions 

• Correlation - correlation (AFL 1.4) 

• LinearReg - linear regression end-point (AFL 2.2) 

• LinRegIntercept - (AFL 2.2) 

• LinRegSlope - linear regression slope (AFL 1.4) 

• Median - calculate median (middle element) (AFL 2.5) 

• mtRandom - Mersene Twister random number generator (AFL 3.0) 

• mtRandomA - Mersene Twister random number generator (array version) (AFL 3.0) 

• Percentile - calculate percentile (AFL 2.5) 

• Random - random number (AFL 1.9) 

• StdErr - standard error (AFL 1.4) 

• StDev - standard deviation (AFL 1.4) 

• TSF - time series forecast (AFL 2.2) 

String manipulation 

• Asc - get ASCII code of character (AFL 2.80) 

• DateTimeToStr - convert datetime to string (AFL 2.8) 
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• NumToStr - convert number to string (AFL 2.5) 

• printf - Print formatted output to the output window. (AFL 2.5) 

• StrCount - count the occurrences of substring within a string (AFL 3.20) 

• StrExtract - extracts given item (substring) from comma-separated string (AFL 2.4) 

• StrFind - find substring in a string (AFL 2.5) 

• StrFormat - Write formatted output to the string (AFL 2.5) 

• StrLeft - extracts the ieftmost part (AFL 2.0) 

• StrLen - string iength (AFL 1.5) 

• StrMatch - string pattern/wildcard matching (AFL 4.0) 

• StrMid - extracts part of the string (AFL 2.0) 

• StrReplace - string repiace (AFL 2.90) 

• StrRight - extracts the rightmost part of the string (AFL 2.0) 

• StrSort - sort comma-separated item iist (AFL 3.90) 

• StrToDateTime - convert string to datetime (AFL 2.80) 

• StrToLower - convert to iowercase (AFL 2.80) 

• StrToNum - convert string to number (AFL 2.5) 

• StrToUpper - convert to uppercase (AFL 2.80) 

• StrTrim - trim whitespaces from the string (AFL 3.90) 

Trading system toolbox 

• Alertif - trigger aierts (AFL 2.1) 

• ApplyStop - appiy buiit-in stop (AFL 1.7) 

• BarsSince - bars since 

• Cross - crossover check 

• EnableRotationalTrading - Turns on rotationai-trading mode of the backtester (AFL 2.5) 

• Equity - caicuiate singie-symboi equity iine (AFL 2.0) 

• ExRem - remove excessive signais (AFL 1.5) 

• ExRemSpan - remove excessive signais spanning given number of bars (AFL 2.0) 

• Flip -(AFL 1.5) 

• GetBacktesterObject - get the access to backtester object (AFL 2.60) 

• GetOption - gets the vaiue of option in automatic anaiysis settings (AFL 2.60) 

• GetTradingInterface - retrieves OLE automation object to automatic trading interfac (AFL 2.70) 

• Hold - hold the alert signal 

• Ilf - immediate IF function 

• LastValue - last value of the array 

• Optimize - define optimization variable (AFL 1.7) 

• OptimizerSetEngine - select external optimization engine (AFL 3.20) 

• OptimizerSetOption - set the value of external optimizer engine parameter (AFL 3.20) 

• Ref - reference past/future values of the array 

• SetBacktestMode - Sets working mode of the backtester (AFL 3.0) 

• SetCustomBacktestProc - define custom backtest procedure formula file (AFL 2.70) 

• SetFormulaName - set the name of the formula (AFL 2.5) 

• SetOption - sets options in automatic analysis settings (AFL 2.3) 

• SetPositionSize - set trade size (AFL 2.70) 

• SetStopPrecedence - set precedence of built-in stops (AFL 4.0) 

• SetTradeDelays - allows to control trade delays applied by the backtester (AFL 2.1) 

• ValueWhen - get value of the array when condition met (AFL 1.1) 

Exploration / Indicators 

• AddColumn - add numeric exploration column (AFL 1.8) 
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• AddRankColumn - add ranking column(s) according to current sort set by SetSortCoiumns (AFL 
5.70) 

• AddRow - add raw text row to expioration (AFL 4.0) 

• AddSummaryRows - add summary row(s) to the expioration output (AFL 3.2) 

• AddTextColumn - add text exploration column (AFL 1.8) 

• EncodeColor - encodes color for indicator title (AFL 2.2) 

• GetChartID - get current chart ID (AFL 2.3) 

• GetPriceStyle - get current price chart style (AFL 2.70) 

• LineArray - generate trend-line array (AFL 2.5) 

• Param - add user user-definable numeric parameter (AFL 2.3) 

• ParamColor - add user user-definable color parameter (AFL 2.3) 

• ParamDate - add user user-definable date parameter (AFL 2.60) 

• ParamField - creates price field parameter (AFL 2.70) 

• ParamList - creates the parameter that consist of the list of choices (AFL 2.70) 

• ParamStr - add user user-definable string parameter (AFL 2.3) 

• ParamStyle - select styles applied to the plot (AFL 2.70) 

• ParamTime - add user user-definable time parameter (AFL 2.60) 

• ParamToggle - create Yes/No parameter (AFL 2.70) 

• ParamTrigger - creates a trigger (button) in the parameter dialog (AFL 2.70) 

• Plot - plot indicator graph (AFL 1.8) 

• PlotGrid - Plot horizontal grid line (AFL 2.3) 

• PlotOHLC - plot custom OHLC chart (AFL 2.2) 

• PlotShapes - plots arrows and other shapes (AFL 2.3) 

• PlotVAPOverlay - plot Volume-At-Price overlay chart (AFL 2.4) 

• SelectedValue - retrieves value of the array at currently selected date/time point (AFL 2.1) 

• SetChartOptions - set/clear/overwrite defaults for chart pane options (AFL 2.70) 

• SetSortCoiumns - sets the columns which will be used for sorting in AA window (AFL 2.90) 

• Writelf - commentary conditional text output 

• WrIteVal - converts number to string 

• XYChartAddPoInt - add point to exploration scatter (XY) chart (AFL 3.60) 

• XYChartSetAxIs - set the names of X and Y axes in exploration scatter charts (AFL 3.60) 

• _DEFAULT_NAME - retrive default name of the plot (AFL 2.70) 

• _N - no text output (AFL 2.1) 

• _PARAM_VALUES - retrieve param values string (AFL 2.70) 

• _SECTION_BEGIN - section begin marker (AFL 2.70) 

• _SECTION_END - section end marker (AFL 2.70) 

• _SECTION_NAME - retrieve current section name (AFL 2.70) 

File Input/Output functions 

• fclose - close a file (AFL 2.5) 

• fdelete - deletes a file (AFL 2.70) 

• fdir - list directory content (AFL 3.70) 

• feof - test for end-of-file (AFL 2.5) 

• fgets - get a string from a file (AFL 2.5) 

• fgetstatus - retrieves file status/properties (AFL 2.90) 

• fmkdir - creates (makes) a directory (AFL 2.70) 

• fopen - open a file (AFL 2.5) 

• fputs - write a string to a file (AFL 2.5) 

• frmdir - removes a directory (AFL 2.70) 


Low-level graphics 
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• GfxArc - draw an arc (AFL 3.0) 

• GfxChord - draw a chord (AFL 3.0) 

• GfxCircle - draw a circle (AFL 3.0) 

• GfxDrawText - draw a text (clipped to rectangle) (AFL 3.0) 

• GfxEllipse - draw an ellipse (AFL 3.0) 

• GfxGetTextWidth - get pixel width of text (AFL 2.80) 

• GfxGradientRect - draw a rectangle with gradient fill (AFL 3.0) 

• GfxLineTo - draw a line to specified point (AFL 3.0) 

• GfxMoveTo - move graphic cursor to new position (AFL 3.0) 

• GfxPie - draw a pie (AFL 3.0) 

• GfxPolygon - draw a polygon (AFL 3.0) 

• GfxPolyline - draw a polyline (AFL 3.0) 

• GfxRectangle - draw a rectangle (AFL 3.0) 

• GfxRoundRect - draw a rectangle with rounded corners (AFL 3.0) 

• GfxSelectFont - create / select graphic font (AFL 3.0) 

• GfxSelectHatchBrush - select hatch style brush (AFL 4.0) 

• GfxSelectPen - create / select graphic pen (AFL 3.0) 

• GfxSelectSolidBrush - create / select graphic brush (AFL 3.0) 

• GfxSetBkColor - set graphic background color (AFL 3.0) 

• GfxSetBkMode - set graphic background mode (AFL 3.0) 

• GfxSetCoordsMode - set low-level graphics co-ordinate mode (AFL 2.80) 

• GfxSetOverlayMode - set low-level graphic overlay mode (AFL 3.0) 

• GfxSetPixel - set pixel at specified position to specified color (AFL 3.0) 

• GfxSetTextAlign - set text alignment (AFL 3.0) 

• GfxSetTextColor - set graphic text color (AFL 3.0) 

• GfxSetZOrder - set current low-level graphic Z-order layer (AFL 2.80) 

• GfxTextOut - writes text at the specified location (AFL 3.0) 

Matrix functions 

• Matrix - create a new matrix (AFL 4.0) 

• MxGetSize - get size of the matrix (AFL 4.0) 

• Mxidentity - create an identity matrix (AFL 4.0) 

• MxTranspose - creates transpose of an input matrix (AFL 4.0) 

Referencing other symboi data 

• Foreign - access foreign security data (AFL 1.5) 

• GetBaseindex - retrieves symbol of relative strength base index (AFL 2.1) 

• PiotForeign - plot foreign security data (AFL 2.2) 

• ReiStrength - comparative relative strength (AFL 1.3) 

• RestorePriceArrays - restore price arrays to original symbol (AFL 2.5) 

• SetForeign - replace current price arrays with those of foreign security (AFL 2.5) 

Time Frame functions 

• TimeFrameCompress - compress single array to given time frame (AFL 2.5) 

• TimeFrameExpand - expand time frame compressed array (AFL 2.5) 

• TimeFrameGetPrice - retrieve O, H, L, C, V values from other time frame (AFL 2.5) 

• TimeFrameMode - switch time frame compression mode (AFL 2.80) 

• TimeFrameRestore - restores price arrays to original time frame (AFL 2.5) 

• TimeFrameSet - switch price arrays to a different time frame (AFL 2.5) 
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#include 

- preprocessor include command 


Miscellaneous functions 

(AFL 2.2) 


SYNTAX #include 

RETURNS nothing 

FUNCTION Includes external AFL files into your formula. Note 1: include statement need SINGLE 
backslashes in the path (this is quite the opposite to normal AFL sting 
parsing) 

Note 2: using #include command may slow down formula execution even 
considering the fact that AmiBroker tries to include only once and cache pre-processed text 
Note 3: that currently no error message is given if #include fails and this code 
is experimental. 

Note 4: nesting #include commands is now supported (version 5.10 and above) 

Note 5: by default files included are cached by the AmiBroker. To turn off caching use 
#pragma nocache 

before any #include statements. #include now accepts new way of specifying file names to 
include: 

#include <filename.afl> 

(note < > braces instead of"") if you specify the file name this way AmiBroker will look for 
the file in "standard include path" that is definable using new prefs setting in 
Tools->Preferences->AFL It makes much shorter to write includes and you can move include 
folder now without changing all AFL codes using includes. 

For example if you have set standard include path to "C:\AFL\Mylncludes" and write in your 
formula: 


#include <common.afl> 

AmiBroker will look for C:\AFL\Mylncludes\common.afl file 

Also now #include reports file(s) not found in regular error message box. 
EXAMPLE #include "C:\Program Files\AmiBroker\AFL\common.afl" 

SEE ALSO #pragma() function 

References: 


The #include function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


#include - preprocessor include command 
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#include_once 

- preprocessor include (once) command 


Miscellaneous functions 

(AFL 2.70) 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 

SEE ALSO 
References: 


#include "formula file path" 

nothing 

Includes external AFL files into your formula. Similar to #include but #include_once performs 
inclusion only once per formula. So if single formula has multiple #include_once commands 
for the same file (for example because of drag-and-drop overlay) it prevents syntax errors 
that could occur due to repeated definitions of functions in included file. More information can 
be found in #include command docs. 

#include_once "myfile.afi" 

#include() function 


The #include_once function is used in the following formulas in AFL on-line library: 

More Information: 


Updated on-line reference 


#include_once - preprocessor include (once) command 
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#pragma 

- sets AFL pre-processor option 


Miscellaneous functions 

(AFL 2.4) 


SYNTAX #pragma optionname 

RETURNS NOTHING 

FUNCTION Sets various AFL pre-processor options. Pre-processor is a part of AFL engine that 

processes formuias BEFORE they are executed. Currentiy the oniy task of pre-processor is 
to inciude externai fiies via #inciude command. 

#pragma aiiows to change pre-processor behaviour. 


Currently the only option available via #pragma is nocache 
#pragma nocache 

causes that included files are not cached so they are re-read with every execution 
#pragma nocache 

must be placed before any #include commands. Note: between '#pragma' and 'nocache' 
there must be exactly SINGLE space 

Note 2: disabling caching mav slow down execution of the formula fesDeciallv in 

indicators)!!! 

EXAMPLE #pragma nocache 

#include "myfile.af1" 

SEE ALSO #include() function 

References: 


The #pragma function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


^pragma - sets AFL pre-processor option 
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abs 

- absolute value 


SYNTAX abs( NUMBER) 

abs( ARRAY) 

RETURNS NUMBER 

ARRAY 

FUNCTION Calculates the absolute value of the NUMBER or ARRAY. 

EXAMPLE The formula "abs( -15 )" will return h- 15; the formula "abs( 15)" also returns h-15. 

SEE ALSO 
References: 


The abs function Is used In the following formulas In AFL on-line library: 

• Absolute Breadth Index 

• Adaptave Zones 0/B & 0/S Oscillator 

• Adaptive Laguerre Filter, from John Ehlers 

• ADXbuy 

• Against all odds 

• Analytic RSI formula 

• Another Fib Level 

• Application of Ehler filter 

• AR_Predlctlon.afl 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• Auto-Optimizatlon Framework 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Better Bollinger Bands 

• Bullish Percent Index 2 files combined 

• Candle Identification 

• Candle Pattern Function 

• Candle Stick Analysis 

• Candlestick Comentary-Help needed 

• Candlestick Commentary 

• Candlestick Commentary Modified 

• Candlestick Commentary-modified 

• CandleStochastIcs 

• CCT Kaleidoscope 

• Chandelier Exit 

• com-out 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• Cybernertic Hilbert Sine Wave 

• Demand Index 

• Double top detection 

• Dynamtic Momentum Index 

• Ed Seykota's TSP: EMA Crossover System 


abs - absolute value 
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• Elder Triple Screen Trading System 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gann Swing Charts in 3 modes with text 

• Harmonic Patterns 

• Head & Shoulders Pattern 

• Heatmap V1 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• Hilbert Study 

• Hurst Constant 

• John Ehler 

• Kiss and Touch with the Modified True Range 

• MA Difference 20 Period 

• MACD commentary 

• MACD indicator display 

• Market Breadth Chart-In-Chart 

• Market Direction 

• MDYtoXLSerialDays and XLSerialDaysToDateNum 

• Modified Head & Shoulder Pattern 

• Multicycle 1.0 

• Multiple Ribbon Demo 

• Multiple sinus noised 

• Nonlinear Ehlers Filter 

• nth (1 - 8 ) Order Polynomial Fit 

• Option Calls, Puts and days till third friday. 

• Parametric Chande Trendscore 

• Pattern Recognition Exploration 

• prakash 

• Range Expansion Index 

• Raw ADX 

• Rebalancing Backtest avoiding leverage 

• RSI of Weekly Price Array 

• SectorRSI 

• Sine Wave Indicator 

• TD REI 

• The Mean RSIt 

• The Mean RSIt (variations) 

• tomy_frenchy 

• Triangle exploration using P&F Chart 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Tushar Chande's Projected Range 

• TWS auto-export Executions-file parser 

• ValueChart 

• Vertical Horizontal Filter 

• Vertical Horizontal Filter (VHF) 

• Vic Huebner 

• Visi-Trade 

• Volatility Quality Index 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 


abs - absolute value 
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• ZLEMA ATR Long Only Trading System 
More information: 

Updated on-line reference 


abs- absolute value 
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AccDist Indicators 

- accumulation/distribution 


SYNTAX 

AccDistO 

RETURNS 

ARRAY 

FUNCTION 

Calculates the Accumulation/ Distribution indicator. 


EXAMPLE 


SEE ALSO 


References: 



The AccDist function is used in the foliowing formulas in AFL on-line library: 

• accum/dist mov avg crossover SAR 

• Bollinger band normalization 

More information: 

Updated on-line reference 


AccDist - accumulation/distribution 
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Math functions 


acos 

- arccosine function 


SYNTAX 

acos(X) 

RETURNS 

NUMBER, ARRAY 

FUNCTiON 

Returns the arccosine of NUMBER or ARRAY. The acos function returns the arccosize of x 
in the range 0 to pi radians. If x is less than -1 or greater than 1, acos returns an indefinite. 


EXAMPLE 


SEE ALSO 

COS() function 

References: 



The acos function is used in the foliowing formulas in AFL on-line library: 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

More information: 

Updated on-line reference 


acos 


arccosine function 
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AddColumn 

- add numeric exploration column 


Exploration / Indicators 

(AFL 1.8) 


SYNTAX AddColumn( array, name, format = 1.2, textColor = colorDefault, bkgndColor = 
colorDefault, width = -1, barchart = Null) 

RETURNS NOTHING 

FUNCTION Adds a new column to the exploration result list. The column shows array values and has a 
caption of name. The values are formatted using format specification. 

By default all variables are displayed with 2 decimal digits, but you can change this by 
assigning a different value to this variable: 1.5 gives 5 decimal digits, 1.0 gives no decimal 
digits. (Note for advanced users: the integer part of this number can be used to pad 
formatted number with spaces - 6.0 will give no decimal digits but a number space-padded 
upto 6 characters.) 

Next two parameters allow to modify text and background color, 
special format constants: 

• formatDateTime - produces date time formated according to your system settings 

AddColumn ( DateTimeO, "Date / Time", formatDateTime ); 


• formatChar - allows outputting single ASCII character codes: 

Example (produces signal file accepted by various other programs): 

Buy=Cross(MACD(),Signal()); 

Sell=Cross(Signal 0, MACD()); 

Filter=Buy OR Sell; 

SetOption("NoDefaultColumns", True ); 

AddColumn ( DateTimeO, "Date", formatDateTime ); 

AddColumn( Ilf( Buy, 66, 83 ), "Signal", formatChar ); 

• width parameter allows to control pixel width of the column 

• 'barchart' parameter accepts values from 0...100 represening percentage width of 
bar chart displayed in a cell the in-cell bar chart is drawn with bkcolor (background 
color). 

EXAMPLE 1. Simple column showing close price 


addcolumn( Close, "Close price", 1.4 ); 

2. Colorful output 

Filter =1; 


Addcolumn( Close, "Close", 1.2 ); 

Addcolumn( MACD(), "MACD", 1.4 , IIf( MACD() 
colorRed ) ); 

AddTextColumn ( FullNameO, "Full name", 77 , 
Close < 10, colorLightBlue, colorDefault ) ) 


> 0, colorGreen, 
colorDefault, IIf( 


3. Barchart example Filter=l; 

Addcolumn ( Close, "Close" ); 


AddColumn - add numeric exploration column 
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rank = PercentRank ( Close, 100 ); 

Color = ColorHSB ( rank * 64/100, 255, 255 ); 

AddColumn ( rank, "100-day percent rank", 1.2, colorDefault, Color, 
-1, rank ); 

SEE ALSO ADDTEXTCOLUMNO function 

References: 

The AddColumn function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Advanced MA system 

• ADXbuy 

• AFL Exampie 

• AFL Exampie - Enhanced 

• Alert Output As Quick Rewiev 

• Appel's ROC or The Triple Momentum Timing Model 

• Aroon Indicators 

• Auto-Optimization Framework 

• AutoTrade using an Exploration 

• Average Dollar Price Volatility Exploration 

• Black Scholes Option Pricing 

• Bottom Fisher Exploration 

• Bull Fear / Bear Fear 

• Bullish Percent Index 2 files combined 

• Calculate composites for tickers in list files 

• CAMSLIM Cup and Handle Pattern AFL 

• Commodity Selection Index (CSI) 

• Count Tickers in Watchlist 

• CVR-severe filter 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• ekeko price chart 

• Elder Impulse Indicator V2 

• End Of Year Trading 

• Follow the Leader 

• Gordon Rose 

• half-automated Trading System 

• IBD relative strength database Viewer 

• ICHIMOKU SIGNAL TRADER 

• Intraday Average Volume 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• JEEVAN'S SRI CHAKRA 

• Market Facilitation Index VS Volume 

• mitalpradip 

• Monthly bar chart 

• MS Darvas Box with Exploration 

• NRx Exploration 

• nth (1 - 8 ) Order Polynomial Fit 

• Ord Volume 

• Pattern_-_Rectangle_Base_Breakout_on_High_Vol 2 


AddColumn- add numeric exploration column 
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• Position Sizer vers2, stocks and CFDs 

• Price Persistency 

• Ranking and sorting stocks 

• Reiative Strength 

• Robert Antony 

• RSI Doubie-Bottom 

• RSI Trendlines and Wedges 

• RUTVOL timing signal with BB Scoring routine 

• Sainath Sidgiddi 

• SAR-ForNextBarStop 

• SectorRSI 

• Simple Candle Exploration 

• STD_STK Multi 

• StochD_StochK Single.afl 

• Stops Implementation in AFS 

• Strength and Weakness 

• TAZ Trading Method Exploration 

• testing multiple system simulataneously 

• Three Day Balance Point 

• Trend Detection 

• Trend exploration with multiple timeframes 

• Trend Exploration: Count Number of New Highs 

• Trend Exploration: Slope Moving Average 

• Triangle exploration using P&F Chart 

• Triangular Moving Average new 

• Using From and To dates from Auto Analysis in Code 

• Volume - compared with Moving Avg (100%) 

• Weekly chart 

• Weighted Index 

• William's Alligator System II 

More information: 

Updated on-line reference 


AddColumn- add numeric exploration column 
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AddRankColumn 

- add ranking column(s) according to current sort set by 
SetSortCoiumns 


Exploration / 
Indicators 

(AFL 5.70) 


SYNTAX AddRankColumnQ 
RETURNS NOTHING 


FUNCTION The function adds ranking column(s) according to current sort set by SetSortCoiumns to 
exploration result list. 

EXAMPLE Filter = 1 ; 

AddColumn ( Close, "Close" ); 

AddColumn ( Volvime, "BI" ) ; 

AddSummaryRows ( 31 + 32, 1.5 ) ; 


AddRankColumn 0 ; // without prior sorting AddRankColumn just adds 

line number 
SetSortCoiumns ( -4 ); 

AddRankColumn 0; // rank according to 4th column (descending) 

SetSortCoiumns ( -3 ); 

AddRankColumn 0; // rank according to 3rd column (ascending) 


SEE ALSO SetSortColumnsO function 

References: 


The AddRankColumn function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


AddRankColumn - add ranking column(s) according to current sort set by SetSortCoiumns 
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AddRow 

- add raw text row to exploration 


Exploration / Indicators 

(AFL 4.0) 


SYNTAX AddRowC'text") 
RETURNS NOTHING 


FUNCTION The function adds a raw text row to the exploration (allows outputing things without 

respecting Filter and without being limited to number of bars). This function is preliminary and 
its parameters are subject to change. 

EXAMPLE SetOption ( "NoDefaultColumns " , True ); 

Filter = 1; 

AddColumn ( Close, "Columnl" ); 

AddColumn ( Null, "Column2" ) ; 


for ( i = 0; i < 10; i++ ) 

{ 

AddRow ( StrFormat ( "row %g second column", i ) ); 

} 

SEE ALSO AddColumnO function , AddTextColumn() function 

References: 


The AddRow function is used in the following formulas in AFL on-line library: 

More Information: 


Updated on-line reference 


AddRow - add raw text row to exploration 
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AddSummaryRows 

- add summary row(s) to the exploration output 


Exploration / Indicators 

(AFL 3.2) 


SYNTAX AddSummaryRows( flags, format = 0, onlycols = 0,...) 

RETURNS NOTHING 

FUNCTION AddSummaryRows automatically adds "summary" row(s) to the exploration output. 
Parameters: 


The flags parameter can be combination of the following: 

• 1 - add TOTAL row 

• 2 - add AVERAGE row 

• 4 - add MIN row 

• 8 - add MAX row 

• 16-add COUNT row 

• 32 - add STANDARD DEVIATION row (new in 5.70) 

format - defines the numeric formating in WriteVal style so 1.2 for example means 2 decimal 
digits. 

If default value of zero is used (or parameter not specified) the default formatting of 
"maximum precision" is used - upto 15 digits are printed 

onlycols - defines for which columns you want to display summary row values. Note that if 
you do not specify any columns - ALL will be printed. 

If you are using onlycols, you can define upto 10 columns, columns, like in SetSortColumns 
are numbered starting from 1. For example: 

AddSummaryRows( 1, 1.2, 3, 5, 7, 9 ); 

Display sum for columns: 3, 5, 7, and 9. 

Generally you should call this funciton only once, using combination of flags desired. But it is 
possible to call AddSummaryRows multiple times and the result will be "accumulation" (i.e. 
bitwise OR) in case of "flag" parameter, format and onlycols are always overwritten by last 
call. 

EXAMPLE Filter=l; 

AddColumn (V, "Volume" ) ; 

AddSummaryRows ( 31, 1.2 ) ; 

// add Total, Average, Min, Max, and Count rows (1+2+4+8+16)=31 - 
with two decimal places summary rows are added at the top of the 
list 

SEE ALSO AddColumnO function , AddTextColumn() function 

References: 


The AddSummaryRows function is used in the following formulas in AFL on-line library: 


AddSummaryRows - add summary row(s) to the exploration output 
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More information: 

Updated on-line reference 


AddSummaryRows- add summary row(s) to the exploration output 
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AddTextColumn 
- add text exploration column 


Exploration / Indicators 

(AFL 1.8) 


SYNTAX AddTextColumn( string, name, format = 1.2, textColor = colorDefault, bkgndColor = 
colorDefault, width = -1 ) 

RETURNS NOTHING 


FUNCTION Adds a new text column to the exploration result list. The column shows fexf and has a 
caption of name. 

Next two parameters allow to modify text and background color. 

Width parameter allows to control pixel width of the column 

EXAMPLE addtextcolumn( GrouplD( 1 ), "The name of the group"); 

SEE ALSO ADDCOLUMNO function 

Comments: 


Tomasz 

Please note that AddTextColumn takes single string as a parameter, so you can only 

Janeczko 

display text that does NOT vary on bar-by-bar basis. 

2005-08-10 


06:35:35 



References: 


The AddTextColumn function is used in the following formulas in AFL on-line library: 

• AFL Example 

• AFL Example - Enhanced 

• Alert Output As Quick Rewiev 

• AutoTrade using an Exploration 

• Average Dollar Price Volatility Exploration 

• Bottom Fisher Exploration 

• Dave Landry PullBack Scan 

• Elder Impulse Indicator V2 

• Elder Triple Screen Trading System 

• IBD relative strength database ranker 

• ICHIMOKU SIGNAL TRADER 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• Market Facilitation Index VS Volume 

• MS Darvas Box with Exploration 

• NRx Exploration 

• Relative Strength 

• Scan New High and New Low 

• Stress with SuperSmoother 

• Trend exploration with multiple timeframes 

• Trend Exploration: Count Number of New Highs 

• Trend Exploration: Slope Moving Average 

• Triangular Moving Average new 

• William's Alligator System II 


AddTextColumn - add text exploration column 
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• WLBuildProcess 
More information: 

Updated on-line reference 


AddTextColumn- add text exploration column 
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AddToComposite 
- add value to composite ticker 


Composites 

(AFL 2.0) 


SYNTAX AddToComposite( array, "ticker", "fieid", fiags = atcFiagDefauits) 

RETURNS NOTHING 

FUNCTiON Allows you to create composite indicators with ease. More info... 

Parameters: 

array - the array of vaiues to be added to "fieid" in "ticker" composite symboi 

"ticker" - the ticker of composite symboi. It is advised to use -comp (tiide at the beginning) 

newiy added composites are assigned to group 253 by defauit and 

have "use only local database" feature switched on for proper operation with external 

sources possible field codes: "C" - close , "O" - open, "H" - high, "L" - low, "V" - volume, "I" - 

open interest, "1" - Aux1 field, "2" - Aux2 field, "X" - updates all OHLC fields at once 

flags - contains the sum of following values 


• atcFlagDeleteValues = 1 - deletes all previous data from composite symbol at the 
beginning of scan (recommended) 

• atcFlagCompositeGroup = 2 - put composite ticker into group 253 and EXCLUDE all 
other tickers from group 253 (avoids adding composite to composite) 

• atcFlagTimeStamp = 4 - put last scan date/time stamp into FullName field 

• atcFlagEnableInBacktest = 8 - allow running AddToComposite in 
backtest/optimization mode 

• atcFlagEnablelnExplore = 16 - allow running AddToComposite in exploration mode 

• atcFlagResetValues = 32 - reset values at the beginning of scan (not required if you 
use atcFlagDeleteValues) 

• atcFiagDefauits = 7 

(this is a composition of atcFlagResetValues | atcFlagCompositeGroup | 
atcFlagTimeStamp flags) 

• atcFlagEnableInPortfolio = 64 - allow running AddToComposite in custom portfolio 
backtester phase 

• atcFlagEnablelnIndicator = 128 - allow running AddToComposite in indicator mode 

AddToComposite function also detects the context in which it is run 
(it works ONLY in scan mode, unless atcFlagEnableInBacktest or atcFlagEnablelnExplore 
flags are specified) and does NOT affect composite ticker when run in Indicator or 
Commentary mode, so it is now allowed to join scan and indicator into single formula. 

EXAMPLE AddToComposite ( MACD () > 0, "-BullMACD", "V"); 

GraphO = Foreign ( "~BullMACD" , "V"); 

// Now you can use the same formula in scan AND indicator 

SEE ALSO 

References: 


The AddToComposite function is used in the following formulas in AFL on-line library: 

• 30 Week Hi Indicator - Calculate 

• 52 Week New High-New Low Index 


AddToComposite - add value to composite ticker 
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• Bad Tick Trim on 5 sec database 

• Buiiish Percent Index 2 fiies combined 

• Buiiish Percent Index 2004 

• Calculate composites for tickers in list files 

• Compare Sectors against Tickers 

• Detailed Equity Curve 

• Heatmap V1 

• Improved NH-NH scan / indicator 

• Index of 30 Wk Highs Vs Lows 

• Market Direction 

• Overbought issues, Oversold issues 

• RUTVOL timing signal with BB Scoring routine 

• SectorRSI 

• Stochastic Divergences, PDI, NDI 

• Stochastic OSI & OBI 

• The Mean RSIt 

• The Mean RSIt (variations) 

• The Relative Slope Pivots 

• Trending or Trading ? 

• Weighted Index 

• WLBuildProcess 

More information: 

Updated on-line reference 


AddToComposite- add value to composite ticker 
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ADLine Composites 

- advance/decline line ^ 


SYNTAX 

ADLineQ 

RETURNS 

ARRAY 

FUNCTiON 

Calculates Advance/Decline line indicator 

EXAMPLE 

adlineO 

SEE ALSO 


References: 



The ADLine function is used in the foilowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 


ADLine - advance/decline line 
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Advissues 
- advancing issues 


Composites 

(AFL 1.2) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


AdvIssuesO 

ARRAY 

Returns the number of advancing issues for a given market (the one that currentiy anaiysed 
stock beiongs to) 

advissuesO 


The Advissues function is used in the foilowing formuias in AFL on-line library: 

• Absolute Breadth Index 

• Breadth Thrust 

• McClellan Oscillator 

• McClellan Summation Index 


More information: 

Updated on-line reference 


Advissues - advancing issues 
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AdvVolume 

- advancing issues voiume 


Composites 

(AFL 1.2) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


AdvVolumeO 

ARRAY 

Returns the volume of advancing issues for a given market (the one that currently analysed 
stock belongs to) 

advvolumeO 


The AdvVolume function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


AdvVolume - advancing issues volume 
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ADX 

- average directional movement index 

SYNTAX adx( period = 14 ) 

RETURNS ARRAY 

FUNCTION Calculates Average Directional Index Indicator 

EXAMPLE adx(), adx(20) 

SEE ALSO 
References: 

The ADX function Is used In the following formulas In AFL on-line library: 

• Advanced MA system 

• ADX Indicator - Colored 

• ADXR 

• babaloo chapora 

• Bollinger band normalization 

• Bull Fear / Bear Fear 

• Dave Landry Pullbacks 

• DMI Spread Index 

• ekeko price chart 

• Gordon Rose 

• Heatmap V1 

• ICHIMOKU SIGNAL TRADER 

• Index and ETF trading 

• Mndahoo ADX 

• Multiple Ribbon Demo 

• Perceptron 

• swing chart 

• TAZ Trading Method Exploration 

• TrendIngRIbbonArrowsADX 

More information: 

Updated on-line reference 


indicators 

(AFL 1.3) 


ADX - average directional movement index 
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Alertif 

- trigger alerts 


Trading system toolbox 

(AFL 2.1) 


SYNTAX Alertlf( BOOLEAN_EXPRESSION, command, text, type = 0, flags = 1+2+4+8, lookback 
= 1 ); 

RETURNS nothing 

FUNCTION Triggers aiert action if BOOLEAN_EXPRESSiON is true. 

1. BOOLEAN EXPRESSION is the expression that if evaiuates to True (non zero vaiue) 
triggers the aiert. if it evaiuates to Faise (zero vaiue) no aiert is triggered. Piease note that 
oniy lookback most recent bars are considered. 

2. The command string defines the action taken when aiert is triggered, if it is empty the aiert 
text is simpiy dispiayed in the Aiert output window (View->Aiert Output). Other supported 
vaiues of command string are: 

SOUND the-path-to-the-WAV-file 
EMAiL 

EXEC the-path-to-the-file-or-URL 
SOUND command piays the WAV fiie once. 

EMAiL command sends the e-maii to the account defined in the settings 
(Toois->Preferences->E-maii). The format of the e-maii is as foiiows: Subject: Aiert 
type_name (type) Ticker on Date/Time 
Body: text 

EXEC command iaunches externai appiication or fiie or URL specified after EXEC command, 
are attached after fiie name and fexf is attached at the end 

3. Text defines the text that wiii be printed in the output window or sent via e-maii or added 
as argument to the appiication specified by EXEC command 

4. Type defines type of the aiert. Pre-defined types are 0 - defauit, 1 - buy, 2 - seii, 3 - short, 
4- cover. YOu may specify higher vaiues and they wiii get name "other" 

5. F/ags controi behaviour of AiertiF function. This fieid is a combination (sum) of the 
foiiowing vaiues: 

(1 - dispiay text in the output window, 2 - make a beep (via computer speaker), 4 - don't 
dispiay repeated aierts having the same type, 8 - don't dispiay repeated aierts having the 
same date/time) By defauit aii these options are turned ON. 

6. /ookback parameter controis how many recent bars are checked 

EXAMPLE Buy = Cross ( MACD () , Signal () ); 

Sell = Cross ( Signal(), MACD() ); 

Short = Sell; 

Cover = Buy; 

AlertIF( Buy, "EMAIL", "A sample alert on "+FullName(), 1 ); 

AlertIF ( Sell, "SOUND C:\\Windows\\Media\\Ding.wav", "Audio alert", 

2 ); 

AlertIF ( Short, "EXEC Calc.exe", "Launching external application", 3 


Alertif - trigger alerts 
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); 

AlertIF( Cover, "Simple text alert", 4 ); 

Note EXEC command uses ShellExecute function and allows not only EXE files but URLs 
too. 


SEE ALSO 
References: 

The Alertif function is used in the following formulas in AFL on-line library: 

• AFL Example - Enhanced 

• Alert Output As Quick Rewiev 

• Basket Trading System T101 

• CCI(20) Divergence Indicator 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• JEEVAN'S SRI CHAKRA 

• Rl - Auto Trading System 

• Stock price Alertif 

• Trading ATR 10-1 

More information: 

Updated on-line reference 


Alertif- trigger alerts 
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AlmostEqual 

- rounding error insensitive comparison 


Math functions 

(AFL 2.80) 


SYNTAX AlmostEquaK x, y, ulps = 5) 

RETURNS NUMBER 

ARRAY 

FUNCTION This is a heiper function for comparing fioating point numbers, it returns True if x and y are 
equai or aimost equai upto defined accurracy (uips). it is recommended to use this function 
instead of equaiity check (==) as it ieads to more reiiabie comparisons and iess headache 
caused by iEEE fioating pointacurracy issues. 

Parameters: 


• X, y - the numbers or arrays to be compared, 

• ulps stands for "units in iast piace" and represents maximum reiative error of the 
comparison. Since 32 bit iEEE fioating point numbers have accurracy of 7 significant 
digits, 1 unit in iast piace(uip) represents reiative error of 0.00001 %. The defauit 
vaiue of uips parameter is 5 which gives roughtiy 0.00005% "comparison sensitivity". 

Thanks to Bruce Dawson for his fast routine. 

EXAMPLE if( 1/3 == 0.3333333 ) 

{ 

printf (" 32-bit Floating point IEEE exact equalityXn" ); 

} 

if ( AlmostEqual ( 1/3, 0.3333333 ) ) 

{ 

printf ( "Numbers are almost equal\n"); 

} 

SEE ALSO 
References: 


The AlmostEqual function is used in the foiiowing formuias in AFL on-iine iibrary: 

More Information: 


Updated on-iine reference 


AlmostEqual - rounding error insensitive comparison 
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AMA 

- adaptive moving average 


Moving averages, summation 

(AFL 1.5) 


SYNTAX ama( ARRAY, SMOOTHiNGFACTOR ) 

RETURNS ARRAY 

FUNCTiON calculates adaptive moving average - similar to EMA() but smoothing factor could be 
time-variant (array). 

EXAMPLE The example of volatility-weighted adaptive moving average formula: graphO = ema( close, 
15); 

fast = 2/(2-Hl); 
sIow = 2/(30-h1); 
dlr=abs(close-ref(close,-10)); 
vol=sum(abs(close-ref(close,-1)),10); 

ER=dlr/vol; 

sc =( ER*(fast-slow)-i-slow)^2; graphO = ama( close, sc ); 

SEE ALSO 
Comments: 


Tomasz Janeczko output = AMA( Input, factor) 

2006-04-26 20:13:15 Is equivalent to the following looping code: 

for( I = 1; I < BarCount; I-i-h- ) 

{ 

output[ I ] = factor[ I ] * lnput[ I ] -i- (1 - factor[ I ]) * output[ I -1 ]; 

_ |} _ 

References: 

The AMA function Is used In the following formulas In AFL on-line library: 

• Application of Ehler filter 

• Auto-Optimizatlon Framework 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• automatic trendlines using fractal patterns 

• Better Bollinger Bands 

• Bman's HaDIffCO 

• candlestick chart for Volume/RSI/OBV 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• com-out 

• Heatmap VI 

• Helkin AshI Candles 

• Helkln-Ashl(Koma-Ashl) with Moving Average 

• HeInkIn-AshI 

• Hilbert Study 

• IFT of RSI - Multiple TImeFrames 


AMA - adaptive moving average 
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• INTRADAY HEIKIN ASHI new 

• Intraday Volume EMA 

• Pivots for Intraday Forex Charts 

• shailu lunia 

• Vikram's Floor Pivot Intraday System 

• Woodie's CCI Panel Full Stats 

• Woodie's Heikin-Ashi Panel 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


AMA- adaptive moving average 
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AMA2 

- adaptive moving average 


Moving averages, summation 

(AFL 1.5) 


SYNTAX ama2( ARRAY, SMOOTHiNGFACTOR, FEEDBACKFACTOR ) 
RETURNS ARRAY 


FUNCTiON calculates adaptive moving average - similar to EMA() but smoothing factor could be 
time-variant (array). 

AMA2 has a separate control of feedbackfactor which Is normally 
(1-SMOOTHINGGFACTOR). Internally this function works like this: today_ama = 
SMOOTHINGFACTOR * array -h FEEDBACKFACTOR * yesterday_ama 

EXAMPLE The example of volatility-weighted adaptive moving average formula: graphO = ema( close, 
15); 

fast = 2/(2-r1); 
slow = 2/(30-r1); 
dlr=abs(close-ref(close,-10)); 
vol=sum(abs(close-ref(close,-1 )),10); 

ER=dlr/vol; 

sc =( ER*(fast-slow)-i-slow)^2; graphO = ama2( close, sc, 1-sc); 

SEE ALSO 
References: 


The AMA2 function Is used In the following formulas In AFL on-line library: 

• Candle Stick Analysis 

• Cycle Period 

• Intraday Volume EMA 

• mitalpradip 

More information: 


Updated on-line reference 


AMA2 - adaptive moving average 
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ApplyStop 
- apply built-in stop 


Trading system toolbox 

(AFL 1.7) 


SYNTAX ApplyStop( type, mode, amount, exitatstop, volatile = False, ReEntryDelay = 0, 
ValidFrom = 0, ValidTo = -1) 

RETURNS Nothing 

FUNCTION controls built-in stops from the formula level (allows optimization of stops) 
Parameters: 


type = 

0 = stopTypeLoss - maximum loss stop, 

1 = stopTypeProfit - profit target stop, 

2 = stopTypeTrailing - trailing stop, 

3 = stopTypeNBar - N-bar stop 


mode = 

0 - disable stop (stopModeDisable), 

1 - amount in percent (stopModePercent), or number of bars for N-bar stop (stopModeBars), 

2 - amount in points (stopModePoint); 

3 - amount in percent of profit (risk) 

amount = 

percent/point loss/profit trigger/risk amount. 

This could be a number (static stop level) or an array (dynamic stop level) 


ExitAtStop 

ExitAtStop = 0 - means check stops using only trade price and exit at regular trade priced) 
(if you are trading on close it means that only close price will be checked for exits and exit 
will be done at close price) 

ExitAtStop = 1 - check High-Low prices and exit intraday on price equal to stop level on the 
same bar when stop was triggered 

ExitAtStop = 2 - check High-Low prices but exit NEXT BAR on regular trade price. 
volatile - 

decides if amount (or distance) (3rd parameter) is sampled at the trade entry and remains 
fixed during the trade (Volatile = FALSE - old behaviour) or if can vary during the trade 
(Volatile = TRUE) (allows single line Chandelier exit implementation)*^) 

ReEntryDelay - 

how many bars to wait till entering the same stock is allowed. 

ValidFrom - 

defines first bar since entry when stop can generate an exit. 0 means from the very 
beginning 


ApplyStop - apply built-in stop 
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ValidTo - 

defines last bar since entry when stop can generate an exit. -1 means "infinite". By default 
stops are valid all the time (0/-1). 

ValidFrom/ValidTo can be used to create stops that get actived/deactivated in different times. 
This setting is independent for each stop type. It also works in conjunction with 
SetOption("HoldMinBars", x ). HoldMinBars affects BOTH regular exits and stops, preventing 
ALL kind of exits during defined period. ValidFrom/ValidTo works on each stop separately 
and does not affect regular exits. 

Note on using stops: 

Scenario 1: 

you trade on next bar OPEN and want to exit intraday on stop price 
Correct settings: 

ActivateStopsImmediately turned ON 
ExitAtStop = 1 
Trade delays set to one 
Trade price set to open 

Scenario 2: 

you trade on today's close and want to exit intraday on stop price 
Correct settings: 

ActivateStopsImmediately turned OFF 
ExitAtStop = 1 
Trade delays set to zero 
Trade price set to close 

Scenario 3: 

you trade on next day OPEN and want to exit by stop on OPEN price when PREVIOUS day 
H-L range hits stop 
Correct settings: 

ExitAtStop = 2 (NEW) 

Trade delays set to one 
Trade price set to open 

• a) (if you want to have stops executed AFTER regular signals, so cash from stopped 
out positions is NOT available to enter trades the same day) 

ActivateStopsImmediately turned ON 

• b) (if you want to have stops executed BEFORE regular signals, so cash from 
stopped out positions IS available to enter new trades the same day) 

ActivateStopsImmediately turned OFF 


Scenario 4: 

you trade on today's close and want to exit only when today's close price hits the stop level 
Correct settings: 


ApplyStop - apply built-in stop 
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ActivateStopsImmediately turned OFF 
ExitAtStop = 0 
Trade delays set to zero 
Trade price set to close 

LIMITATIONS: 

• C) ExitAtStop = 0 uses SellPrice/CoverPrice variables in backtestRegular mode only, 
in other modes it uses trade prices from the Settings dialog (not overridable via 
SellPrice/CoverPrice) 

• (2) Volatile stops (Volatile=True) work only in backtestRegular mode 

EXAMPLE /* max loss stop optimization */ 

ApplyStop (stopTypeLoss, 

stopModePercent, 

Optimize ( "max. loss stop level", 10, 2, 30, 1 ), 

True ); 

/* single-line implementation of Chandelier exit */ 

ApplyStop (stopTypeTrailing, stopModePoint , 3*ATR(14), True, True ); 

/* N-bar stop */ 

ApplyStop ( stopTypeNBar, stopModeBars, 5 ); 


SEE ALSO 
Comments: 


Herman van den Bergen 

psytek@magma.ca 
2003-02-23 09:53:51 

If you are trading at the Close with zero delays be sure to unmark "Activate Stops 
Immediately" in Settings. 

Corey Saxe 

csaxe@nwi.net 

2003-03-01 23:33:13 

For visual conformation of ApplyStop function, add the following lines below your 
ApplyStop formula in Indicator Builder: 

Equity(l); // THIS EVALUATES STOPS 

Plot(Sell==4,"ApplyStop Sell",colorRed,1 |styleOwnScale); 

Plot(Cover==4,"ApplyStop Cover",colorGreen,1 |styleOwnScale); 

Tomasz Janeczko 

tj -at- amibroker.com 
2004-08-28 03:14:12 

If two or more different stops are triggered on the VERY SAME bar then they are 
evaluated in this fixed order: 

Fixed Ruin stop (loosing 99.96% of the starting capital) 

Max. loss stop 

Profit target stop 

Trailing stop 

N-bar stop 

Graham Kavanagh 

gkavanagh@e-wire.net.au 

from equity comments 


ApplyStop- apply built-in stop 
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2004-09-30 21:55:42 

Depending on kind of the stop various values 

are written back to sell/cover array to enable you to distinguish if given signal was 
generated by regular rule or by stop. 

1 - regular exit 

2 - max. loss 

3 - profit target 

4 - trailing 

5 - n-bar stop 

6 - ruin stop 

Tomasz Janeczko 

tj -at- amibroker.com 
2005-03-01 17:10:39 

ExitAtStop has a new meaning for N-BAR stop type. 

If ExitAtStop = 0 then N-bar stop has the lowest priority (so if for example profit 
target stop is hit on the same bar then profit target is evaluated first) 

If ExitAtStop = 1 then N-bar stop has highest priority and it is evaluated before all 
other stops. 

The same effect is obtained by checking "Has priority" box in AA Settings window. 

Tomasz Janeczko 

tj-/nospam/@amibroker.com 
2006-01-13 11:41:32 

ApplyStop function is designed to be used to simulate 

stop orders placed at the exchange or simulated by the brokerage 

Please read this how such stops operate: 

http://www.interactivebrokers.com/en/trading/orders/stop.php?ib_entity=uk 
http://www. interactivebrokers.com/en/trading/orders/trailingStops.php?ib_entity=uk 


References: 


The ApplyStop function is used in the foiiowing formuias in AFL on-iine iibrary: 

• ATR Study 

• AutoTrade using an Exploration 

• danningham penetration 

• Ed Seykota's TSP: EMA Crossover System 

• Follow the Leader 

• Index and ETF trading 

• RUTVOL timing signal with BB Scoring routine 

• SectorRSI 

• The D_oscillator 

• The Three Day Reversal 

• Trend Continuation Factor 

• Vivek Jain 

More information: 

Updated on-line reference 


ApplyStop- apply built-in stop 
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Asc String manipulation 

- get ASCII code of character ^ 


SYNTAX 

Asc( string, pos = 0 ) 

RETURNS 

NUMBER 

FUNCTION 

Returns the ANSI character code corresponding to the first letter in a string (if position is not 
specified) or code of character at specified position. If you don't specify position (pos 
argument) then first character is used. Negative values of pos reference characters counting 
from the end of string. 

EXAMPLE 

Useful for creation of exploration that displays single letters for signals instead of numbers. 

Buy = Cross (MACD 0, Signal 0) ; 

Sell = Cross (Signal 0, MACD 0) ; 

Filter = Buy OR Sell; 

SEE ALSO 

AddColumn ( IIf( Buy, Asc("B"), Asc("S")), "Signal", formatChar ); 

AddColumnO function 

References: 



The Asc function is used in the foilowing formuias in AFL on-line library: 

• AFL_Glossary_1 

• AutoTrade using an Exploration 

• Ed Seykota's TSP: Support and Resistance 

More information: 

Updated on-line reference 


Asc - get ASCII code of character 
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asin Math functions 

- arcsine function 


SYNTAX 

asin( X) 

RETURNS 

NUMBER, ARRAY 

FUNCTiON 

Returns the arcsine of NUMBER or ARRAY. The asin function returns the arcsine of x in the 
range -pi/2 to pi/2 radians. If x is less than -1 or greater than 1, asin returns an indefinite 


EXAMPLE 


SEE ALSO 

SIN() function 

References: 



The asin function is used in the foliowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 


asin - 


arcsine function 
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Math functions 


atan 

- arc tan 


SYNTAX 

atan( NUMBER), 
atan( ARRAY) 

RETURNS 

NUMBER 

ARRAY 

FUNCTiON 

Returns the arc tangent of 

EXAMPLE 

The formula "atan( 1.00 )" 

SEE ALSO 


References: 



NUMBER or ARRAY. The value is returned in radians 
returns PI/4 


The atan function is used in the following formulas in AFL on-line library: 

• Andrews Pitchfork 

• Andrews PitchforkV3.3 

• AR_Prediction.afl 

• Cybernertic Hilbert Sine Wave 

• DMI Spread Index 

• Dominant Cycle Phase 

• Gabriel Linear Regression Angle Indicator 

• Heatmap V1 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• Hilbert Study 

• John Ehler 

• Moving Average "Crash" Test 

• Multiple sinus noised 

• Schiff Lines 

• Signal to Noise 

• Sine Wave Indicator 

• Smoothed Adaptive Momentum 

• Three Pole Butterworth 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

More information: 

Updated on-line reference 


atan - arc tan 
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atan2 

- calculates arctangent of y/x 


Math functions 

(AFL 2.90) 


SYNTAX atan2( y, x ) 

RETURNS NUMBER or ARRAY 


FUNCTION atan2 returns the arctangent of y/x. If x is 0, atan2 returns 0. If both parameters of atan2 are 
0, the function returns 0. atan2 returns a vaiue in the range -PI to -i-PI radians, using the 
signs of both parameters to determine the quadrant of the return vaiue. 


EXAMPLE 


SEE ALSO 
References: 


ffc = FFT (data,Len); 

for ( i = 0 ; i < Len - 1 ; i = i + 2 ) 
{ 


amp[ i ] 
phase[ i 


amp[ i + 1 ] 
= phase[ i + 


= sqrt(ffc[ i ]^ 2 + 

1 ] = atan2 ( ffc[ i + 


ffc[ i + 1 
1], ffc[ i 


2 ) ; 


) ; 


atan() function 


The atan2 function is used in the foiiowing formuias in AFL on-iine iibrary: 


More information: 


Updated on-iine reference 


atan2 - calculates arctangent of y/x 
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ATR 

- average true range 

SYNTAX atr( period) 

RETURNS ARRAY 

FUNCTION Calculates Average True Range Indicator 

EXAMPLE atr(7) 

SEE ALSO 
Comments: 


Indicators 

(AFL 1.3) 


Bob Jagow 

bjagow@charterr.net 
2003-02-06 23:37:50 

For other MAs, use ATR(1) to get the True Range. 

E.g., MA(ATR(1),period), WMA(ATR(1),perlod), etc. 

Tomasz Janeczko 

tj -at- amlbroker.com 
2005-02-03 06:46:39 

Note that original formulation of ATR (the one that AmiBroker Implements) 
uses WILDERS smoothing (not simple moving average) 

For more details check this page: 

http://stockcharts.com/educatlon/lndlcatorAnalysls/lndlc_ATR.html 


References: 


The ATR function Is used In the following formulas In AFL on-line library: 

• Pivots And Prices And Swing Volume 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• AR_Predlctlon.afl 

• ATR Study 

• AutoTrade using an Exploration 

• BB squeeze 

• Bollinger - Keltner Bands 

• Bollinger Band Gap 

• Bow tie 

• Chandelier Exit 

• Chandelier Exit 

• Chandelier Exit or Advanced Trailing Stop 

• Chandelier Plugin 

• Channel/S&R and trendlines 

• Commodity Selection Index (CSI) 

• Fre 

• Gann Swing Charts In 3 modes with text 

• Gartley 222 Pattern Indicator 

• Gordon Rose 

• Hull Range Indicator 

• Keltner Channel 

• mitalpradip 

• Perceptron 

• Peterson 


ATR - average true range 
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• PF Chart - Close - April 2004 

• Pivots And Prices 

• Point & figure Chart India Securities 

• Position Sizing and Risk Price Graph 

• Position Sizing and Risk Price Graph - 2 

• Random Walk Index, base formula included 

• Raw ADX 

• Renko Chart 

• SectorRSI 

• SF Entry,Stop, PT Indicator 

• STARC Bands 

• Steve Woods' Cum. Vol. Float + Cum. Vol. Channels 

• STO & MACD Buy Signals with Money-Management 

• Stop-loss Indicator bands 

• Super Trend Indicator 

• Tracking Error 

• Tracking Error 

• Trading ATR 10-1 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• TTM Squeeze 

• Vivek Jain 

• Volatility Quality Index 

• Volatility System 

• VSTOP (2) 

• VSTOP (3) 

• Weinberg's The Range Indicator 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


ATR- average true range 
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Barindex 

- get zero-based bar number 


Date/Time 

(AFL 2.3) 


SYNTAX BarIndexO 

RETURNS ARRAY 

FUNCTION returns zero-based bar number - the same as Cum(1)-1 but it is much faster than Cum(1) 
when used in Indicators New in 5.30: Barlndex() now returns vaiues aiways starting from 
zero (even if QuickAFL is turned on). This change is required because Cum() now does not 
require aii bars and formuias mixing Cum(1) and Barindex would work improperly otherwise. 


EXAMPLE ThisIsLastBar = BarIndexO == LastValue ( BarIndexO ); 

SEE ALSO CUM() function 

Comments: 


Tomasz Janeczko 

tj -at- amibroker.com 
2004-07-23 07:07:29 

When QuickAFL is ON, the Barlndex() may not be equal with array item index. 

Actual array item 

corresponding to bar index can be found this way: 

bi = BarIndexO; 

arrayitem = SelectedValue( bi) - bi[ 0 ]; 

"Close at selected bar:" -i- Close[ arrayitem ]; 

Roily 

rollyzhang(S)hotmail.com 
2007-11-03 14:12:22 

BarIndexO returns an array and LastValue() returns a number. The API's example 
compares the two to give the boolean ThisIsLastBar. How could an array be 
compared with a number? How could it work? Please explain. 

Tomasz Janeczko 

tj at amibroker dot com 
2007-11-04 09:14:21 

That's simple - it compares each array element to a number and produces array 
as a result. Detailed explanation in User's Guide: Tutorial: Understanding AFL 


References: 


The Barindex function is used in the following formulas in AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Adaptive Price Channel 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• Andrews Pitchfork 

• Andrews PitchforkV3.3 

• Another Fib Level 

• AR_Prediction.afl 

• Auto-Optimization Framework 

• Automatic Trendlines using multiple timeframes 

• babaloo chapora 

• Basket Trading System T101 

• BEANS-Summary of Holdings 

• Bullish Percent Index 2004 


Barindex - get zero-based bar number 
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• Candle Identification 

• Candle Stick Analysis 

• Candle Stick Demo 

• CCI(20) Divergence Indicator 

• Chandelier Exit 

• Channel/S&R and trendlines 

• Chart Zoom 

• com-out 

• Congestions detection 

• crMathLib 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Cycle Period 

• Date_To_Num(), Time_To_Num() 

• Elder safe Zone Long -i- short 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• FirstBarIndexO, LastBarlndex() 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gann Swing Charts in 3 modes with text 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• Hurst "Like" DE 

• Intraday Fibonacii Trend Break System 

• Intraday Range and Periods Framer 

• Intraday Trend Break System 

• Inverted Plotted Volume Overlay Indicator 

• JEEVAN'S SRI CHAKRA 

• Last Five Trades Result Dashboard - AFL code 

• Linear Regression Line w/ Std Deviation Channels 

• MACD indicator display 

• Market Profile 

• MFE and MAE and plot trades as indicator 

• Multiple Ribbon Demo 

• Multiple sinus noised 

• Now Send Push Notifications From Amibroker 

• nth (1 - 8 ) Order Polynomial Fit 

• PF Chart - Close - April 2004 

• Pivot Finder 

• Point & figure Chart India Securities 

• Probability Density & Gaussian Distribution 

• Rea Time Daily Price Levels 

• Relative Strength Multichart of up to 10 tickers 

• Schiff Lines 

• shailu lunia 

• Square of Nine Roadmap Charts 

• suresh 

• tomy_frenchy 


Barindex - get zero-based bar number 
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• Trend Detection 

• Trend exploration with multiple timeframes 

• Trend Exploration: Slope Moving Average 

• Trend Lines from 2 points 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Using From and To dates from Auto Analysis in Code 

• Visible Min and Max Value Demo 

• VWAP - Volume Weighted Average Price 

• WLBuildProcess 

• Woodie's CCI Panel Full Stats 

• Zig Zag Indicator with Valid Entry and Exit Points 

• ZigZag Retracements 

More information: 

Updated on-line reference 


Barindex- get zero-based bar number 
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BarsSince Trading system toolbox 

- bars since 


SYNTAX BarsSince( ARRAY) 

RETURNS ARRAY 

FUNCTION Calculates the number of bars (time periods) that have passed since ARRAY was true (or 1) 

EXAMPLE barsslnce( macd() < 0 ) 

SEE ALSO 
References: 


The BarsSince function Is used In the following formulas In AFL on-line library: 

• Pivots And Prices And Swing Volume 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• Andrews PltchforkV3.3 

• AR_Predlctlon.afl 

• Auto-Optimizatlon Framework 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• Awsome Oscllator 

• Buyer Seller Force 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI Woodies Style 

• CCI(20) Divergence Indicator 

• changing period moving average 

• Channel/S&R and trendlines 

• Cole 

• Commodity Channel Index 

• Connors TPS 

• ConnorsRSI 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Divergences 

• ekeko price chart 

• Elder Impulse Indicator V2 

• Envelope System 

• FastStochK FullStochK-D 

• Fib Fan Based on ZZ 

• Follow the Leader 

• Fre 

• Fund Screener 

• Gann Swing Chart 

• Gann Swing Charts In 3 modes with text 


BarsSince - bars since 
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• Heatmap V1 

• Intraday Average Volume 

• IntraDay Open Marker 

• Intraday Volume EMA 

• Lagging MA-Xover 

• MACD commentary 

• MACD indicator display 

• Market Profile 

• mitalpradip 

• Moving Averages NoX 

• MO_CrashZone 

• OBV with Linear Regression 

• Performance Check 

• Peterson 

• Positive Bars Percentage 

• prakash 

• Price Persistency 

• Rea Time Daily Price Levels 

• Relative Strength Index 

• Reverse MFI Crossover 

• Schiff Lines 

• Stochastic Divergence, negative 

• Stochastic Divergence, positive 

• Stochastic Divergences, PDI, NDI 

• Stochastic Fast%K and Full 

• Stops Implementation in AFS 

• TD sequential 

• TD Sequential 

• The Fibonaccian behavior 

• The Three Day Reversal 

• Trade day of month 

• Trend Analysis_Comentary 

• Triangular Moving Average 

• Triangular Moving Average new 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Trix Bars number 

• VWAP - Volume Weighted Average Price 

• VWAP versus Average Price 

• Williams Alligator system 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Zig Zag Indicator with Valid Entry and Exit Points 

• ZigZag Hi Lo Barcount 

More information: 

Updated on-line reference 


BarsSince- bars since 
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BBandBot indicators 

- bottom bollinger band 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


BBandBot( ARRAY, periods = 15, width = 2 ) 

ARRAY 

Calculates the bottom Bollinger Band of ARRAY shifted down width standard deviations 
(using periods averaging range ). 

bbandbot( close, 10, 2 ) 


The BBandBot function Is used In the following formulas In AFL on-line library: 


• babaloo chapora 

• Bman's HaDIffCO 

• bolingerbands 

• Bollinger - Keltner Bands 

• Bollinger band normalization 

• bonlinger bands 

• Congestions detection 

• ekeko price chart 

• Intraday FIbonacll Trend Break System 

• INTRADAY HEIKIN ASHI new 

• prakash 

• RUTVOL timing signal with BB Scoring routine 

• TTM Squeeze 

• Volatility Breakout with Bollinger Bands 

More information: 


Updated on-line reference 


BBandBot - bottom bollinger band 
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BBandTop indicators 

- top bollinger band 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


BBandTop( ARRAY, periods =15, width = 2 ) 

ARRAY 

Calculates the top Bollinger Band of ARRAY shifted up width standard deviations (using 
periods averaging range). 

bbandtop( close, 10, 2 ) 


The BBandTop function Is used In the following formulas In AFL on-line library: 

• babaloo chapora 

• Bman's HaDIffCO 

• bolingerbands 

• Bollinger - Keltner Bands 

• Bollinger Band Gap 

• Bollinger band normalization 

• bonlinger bands 

• Congestions detection 

• ekeko price chart 

• Intraday FIbonacll Trend Break System 

• INTRADAY HEIKIN ASHI new 

• prakash 

• RUTVOL timing signal with BB Scoring routine 

• TTM Squeeze 

• Volatility Breakout with Bollinger Bands 

More information: 


Updated on-line reference 


BBandTop - top bollinger band 
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BeginValue 

- Value of the array at the begin of the range 


Date/Time 

(AFL 2.3) 


SYNTAX BeginValue( ARRAY) 

RETURNS NUMBER 

FUNCTION This function gives the singie vaiue (number) of the ARRAY at the beginning of the seiected 
range, if no range is marked then the vaiue at the first bar is returned. 


To seiect the range you have to doubie ciick in the chart at the beginning of the range and 
then doubie ciick in the chart at the end of the range. Then > < markers wiii appear above 
date axis. 

EXAMPLE 1 . Simpie commentary: 


WriteVal( BeginValue( DateTimeO ), formatDateTime ); 
WriteVal( EndValue( DateTimeO ), formatDateTime ); 
"Precentage change of close is " + 

WriteVal( 100 * (EndValue( Close ) - BeginValue( Close 
))/BeginValue( Close ) ) + 

2. Get the number of bars in the range and caicuiate some stats for that range: 


Period = EndValue ( BarIndexO ) - BeginValue ( BarIndexO ); 
StandardDeviationInTheRange = EndValue( StDev( Close, Period 


SEE ALSO ENDVALUEO function 

References: 


); 


The BeginValue function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Adaptive Price Channei 

• Another Fib Levei 

• Congestions detection 

• Eider safe Zone Long + short 

• Futures - Doiiar Move indicator 

• nth (1 - 8 ) Order Poiynomiai Fit 

• Reiative Strength Muitichart of up to 10 tickers 

• Trend Lines from 2 points 

More information: 


Updated on-iine reference 


Begin Value - Value of the array at the begin of the range 
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Category AddSymbol 
- adds a symbol to a category 


Information / Categories 

(AFL 2.5) 


SYNTAX CategoryAddSymbol( symbol, category, number) 

RETURNS NOTHING 

FUNCTION The CategoryAddSymbol function adds the symbol to given category, note that for markets, 
groups, industries 'adding' means moving from one category to another, since the symboi is 
assigned aiways to one and oniy one market, group, industry and sector. This iimitation does 
not appiy to watchiists, favorites, and index categories. When symdo/string is empty ("") then 
current symboi is used. 

category is one of the foliowing: 

• categoryMarket 

• categoryGroup 

• categorySector 

• categoryindustry 

• categoryWatchlist 

• categoryFavorite 

• categoryindex 

• categoryGICS 

• categorylCB 

number is a market/group/industry/sector/watchlist number: 

0..255 for categoryMarket, categoryGroup, categoryindustry 

0..63 for categorySector 

no limit for categoryWatchlist. 

ignored for categoryFavorite, categoryindex 


The meaning of index parameter is different for GIGS and ICB categories - the index for 
categoryGICS and categorylCB is actually GICS/ICB code. Such as 10 for energy sector or 
351010 for "Health Care Equipment & supplies" industry. The codes are fixed even if new 
classifications are added at some point in the future. This means that you won't need to 
change AFL codes even if new classifications are added. But it is important to understand 
that these codes work in hierarchical way. So 

GetCategorySymbols( categoryGICS, 10) 

will return all symbols belonging to energy sector, including those in 10101010 - Oil & Gas 
Drilling sector as well as 10102050 - Coal & Consumable Fuels; for example. See 
http://en.wikipedia.org/wiki/Global_lndustry_Classification_Standard for more details on 
GIGS system 

http://en.wikipedia.org/wiki/lndustry_Classification_Benchmark for more details on ICB 
system 

EXAMPLE // the code adds symbols with last day volume > 100000 
// to the watch list number 1 
if ( LastValue ( V ) > 100000 ) 

{ 


CategoryAddSymbol - adds a symbol to a category 
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CategoryAddSymbol ( categoryWatchlist, 1 ); 

} 

SEE ALSO CategoryGetNameO function , CategoryGetSymbols() function 

References: 

The CategoryAddSymbol function is used in the foilowing formulas in AFL on-line library: 

• Calculate composites for tickers in list files 

• Heatmap V1 

• WLBuildProcess 

More information: 

Updated on-line reference 


CategoryAddSymbol- adds a symbol to a category 
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CategoryCreate 

- add new category (such as watch list) 


Information / Categories 

(AFL 3.70) 


SYNTAX CategoryCreateC'name", category) 

RETURNS STRING 

FUNCTION CategoryCreate( "name", category ) - adds new category (currently supports only adding 
watch lists) 

newwl = CategoryCreate ( "name", categoryWatchlist ); 

This will add (create new) watch list with "name" (if it does not exist) or will return existing 
"name" watch list 

newwl will hold new watch list index. 


Currently only creation of watch list is supported by this function. 

EXAMPLE newwl = CategoryCreate ( "name", categoryWatchlist ); 

SEE ALSO CategoryAddSymbolQ function , CategoryFind() function , CategoryGetName() function , 

CategoryGetSymbolsO function , CategoryBemoveSymbolQ function , CategorySetName() 
function 

References: 


The CategoryCreate function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


CategoryCreate - add new category (such as watch list) 
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CategoryFind 

- search for category by name 


Information / Categories 

(AFL 3.0) 


SYNTAX CategoryFind( "name", category) 

RETURNS NUMBER 

FUNCTION It allows to search for category by name. It takes category name and kind as parameters and 
returns INDEX (ordinal number). 

For example it allows to find watch list index by name. 

Supported categories: 

• categoryMarket 

• categoryGroup 

• categorySector 

• categoryindustry 

• categoryWatchlist 

• categoryFavorite 

• categoryindex 

• categoryGICS 

• categorylCB 


The index (in the example below watch list number) can be later used in functions that need 
the index (like CategoryGetSymbols). 

EXAMPLE wlnumber = CategoryFind ( "MyWatch List 1", categoryWatchlist ); 

mysymbols = CategoryGetSymbols (categoryWatchlist, wlnumber ) ; 

SEE ALSO CategoryAddSymbolQ function , CategoryGetName() function , CategoryGetSymbols() 

function , CategoryRemoveSymbolO function 

References: 


The CategoryFind function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


CategoryFind - search for category by name 
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CategoryGetName 
- get the name of a category 


Information / Categories 

(AFL 2.5) 


SYNTAX CategoryGetName( category, numbei) 

RETURNS STRING 

FUNCTION The CategoryGetName function retrieves the name of category. 
category is one of the foiiowing: 

• categoryMarket 

• categoryGroup 

• categorySector 

• categoryindustry 

• categoryWatchiist 

• categoryFavorite 

• categoryindex 

• categoryGICS 

• categorylCB 

number is a market/group/industry/sector/watchiist number: 

0..255 for categoryMarket, categoryGroup, categoryindustry 

0..63 for categorySector 

no limit for categoryWatchiist. 

ignored for categoryFavorite, categoryindex 

The meaning of index parameter is different for GIGS and ICB categories - the index for 
categoryGICS and categorylCB is actually GICS/ICB code. Such as 10 for energy sector or 
351010 for "Health Care Equipment & supplies" industry. The codes are fixed even if new 
classifications are added at some point in the future. This means that you won't need to 
change AFL codes even if new classifications are added. But it is important to understand 
that these codes work in hierarchical way. So 

GetCategorySymbols( categoryGICS, 10) 


will return all symbols belonging to energy sector, including those in 10101010 - Oil & Gas 
Drilling sector as well as 10102050 - Coal & Consumable Fuels; for example. See 
http://en.wikipedia.org/wiki/Global_lndustry_Classification_Standard for more details on 
GICS system 

http://en.wikipedia.org/wiki/lndustry_Classification_Benchmark for more details on ICB 
system 


EXAMPLE 

CategoryGetName ( categoryWatchiist, 1 ); 

SEE ALSO CategoryGetSymbolsO function 

References: 


The CategoryGetName function is used in the following formulas in AFL on-line library: 
• In Watch List 


CategoryGetName - get the name of a category 


609 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


More information: 

Updated on-line reference 


CategoryGetName- get the name of a category 
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Categ ory GetSy m bo I s 

- retrieves comma-separated list of symbols belonging to given 


Information / 
Categories 

(AFL 2.5) 


category 

SYNTAX 

RETURNS 

FUNCTION 


CategoryGetSymbols( category, index, mode = 0) 

STRING 

Retrieves comma-separated list of symbols belonging to given category Supported 
categories: 

• categoryMarket 

• categoryGroup 

• categorySector 

• categoryindustry 

• categoryWatchlist 

• categoryFavorite 

• categoryindex 

• categoryGICS 

• categorylCB 

• categoryAII (new in 5.50) - means all symbols in the database ( 

index is a market/group/industry/sector/watchlist number: 

0..255 for categoryMarket, categoryGroup, categoryindustry 

0..63 for categorySector 

no limit for categoryWatchlist. 

ignored for categoryFavorite, categoryindex 

mode - (new in 5.50) mode parameter decides what field is retrieved: 

• 0 (default value) - ticker symbol 

• 1 - full name 

The meaning of index parameter is different for GIGS and ICB categories - the index for 
categoryGICS and categorylCB is actually GICS/ICB code. Such as 10 for energy sector or 
351010 for "Health Care Equipment & supplies" industry. The codes are fixed even if new 
classifications are added at some point in the future. This means that you won't need to 
change AFL codes even if new classifications are added. But it is important to understand 
that these codes work in hierarchical way. So 

GetCategorySymbols( categoryGICS, 10) 

will return all symbols belonging to energy sector, including those in 10101010 - Oil & Gas 
Drilling sector as well as 10102050 - Coal & Consumable Fuels; for example. See 
http://en.wikipedia.org/wiki/Global_lndustry_Classification_Standard for more details on 
GICS system 

http://en.wikipedia.org/wiki/lndustry_Classification_Benchmark for more details on ICB 
system 

Use StrExtract function to extract individual symbols from the list. 


category 

SYNTAX 

RETURNS 

FUNCTION 
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EXAMPLE /* note; if given watch list contains lots of symbols 
** performance may be poor 
** AVOID SUCH CODES IN REAL-TIME MODE ! 

*/ 

function CreateAverageForWatchList( listnum ) 

{ 

// retrive comma-separated list of symbols in watch list 
list = CategoryGetSymbols ( categoryWatchlist, listnum ); 

Average = 0 ; // just in case there are no watch list members 

for ( i = 0 ; ( sym = StrExtract ( list, i ) ) != "" ; i++ ) 

{ 

f = Foreign ( sym, "C" ); 
if ( i == 0 ) Average = f; 
else Average = Average + f; 

} 

return Average / i; // divide by number of components 

} 

Plot ( CreateAverageForWatchList( 1 ), "Avg of WL 1 ", colorGreen ); 

Example 2, retrieving all symbols tickers and full names // to get all ticker 
symbols 

CategoryGetSymbols ( categoryAll, 0 ); 

//to get full names of all symbols use: 

CategoryGetSymbols ( categoryAll, 0 , 1 ); 

SEE ALSO GETCATEGORYSYMBOLSO function , StrExtract() function , INWATCHLIST() function , 
CategoryGetNameO function 

References: 

The CategoryGetSymbols function is used in the following formulas in AFL on-line library: 

• AELGIossaryf 

• Basket Trading System T101 

• Calculate composites for tickers in list files 

• Graphical sector stock amalysis 

• Heatmap V1 

• IB Backfiller 

• IBD relative strength database ranker 

• Optimal Weights 

• Relative Strength 

More information: 

Updated on-line reference 
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CategoryRemoveSymbol 
- remove a symbol from a category 


Information / Categories 

(AFL 2.5) 


SYNTAX CategoryRemoveSymbol( symbol, category, number) 

RETURNS NOTHING 

FUNCTION Removes the symbol Uom given category. 

Note that for markets, groups, industries 'removing' means moving from given category to 
category with number zero, since the symboi is assigned aiways to one and oniy one market, 
group, industry and sector. This iimitation does not appiy to watchiists, favorites, and index 
categories. When symbol string is empty ("") then current symbol is used. 

category is one of the following: 


• categoryMarket 

• categoryGroup 

• categorySector 

• categoryindustry 

• categoryWatchlist 

• categoryFavorite 

• categoryindex 

• categoryGICS 

• categorylCB 

number is a market/group/industry/sector/watchlist number: 

0..255 for categoryMarket, categoryGroup, categoryindustry 

0..63 for categorySector 

no limit for categoryWatchlist. 

ignored for categoryFavorite, categoryindex 

The meaning of index parameter is different for GIGS and ICB categories - the index for 
categoryGICS and categorylCB is actually GICS/ICB code. Such as 10 for energy sector or 
351010 for "Health Care Equipment & supplies" industry. The codes are fixed even if new 
classifications are added at some point in the future. This means that you won't need to 
change AFL codes even if new classifications are added. But it is important to understand 
that these codes work in hierarchical way. So 

GetCategorySymbols( categoryGICS, 10) 

will return all symbols belonging to energy sector, including those in 10101010 - Oil & Gas 
Drilling sector as well as 10102050 - Coal & Consumable Fuels; for example. See 
http://en.wikipedia.org/wiki/Global_lndustry_Classification_Standard for more details on 
GIGS system 

http://en.wikipedia.org/wiki/lndustry_Classification_Benchmark for more details on ICB 
system 

EXAMPLE // the code removes the symbols with last day volume < 1000 
// from the watch list number 1 
if ( LastValue ( V ) < 1000 ) 


CategoryRemoveSymbol - remove a symbol from a category 
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{ 

CategoryRemoveSymbol ( categoryWatchlist, 1 ) ; 

} 

SEE ALSO CategoryAddSymbolQ function , CategoryGetName() function , CategoryGetSymbois() 

function 

References: 

The CategoryRemoveSymbol function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Caicuiate composites for tickers in iist fiies 

• Heatmap V1 

• WLBuiidProcess 

More information: 

Updated on-line reference 


CategoryRemoveSymbol- remove a symbol from a category 
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CategorySetName 

- set the name of category (group, market, watch list, industry) 


Information / Categories 

(AFL 3.20) 


SYNTAX CategorySetName( name, category, number) 

RETURNS NOTHING 

FUNCTION Function sets the name of category (group,market, watch list, industry) 

Arguments; 

• name - a new name for the category (in case of watch lists it has to be unique) 

• category - type of category, one of the following: categoryMarket, categoryGroup, 
categorySector, categoryindustry, categoryWatchlist, categoryGICS, categorylCB 

• number - the number (index) of the category 0.255 for market, group industry, 0..32 
for sectors, 0...unlimited for watch lists 


Please note that the function will NOT create watch list of given index if one does not exist. 

The meaning of index parameter is different for GIGS and ICB categories - the index for 
categoryGICS and categorylCB is actually GICS/ICB code. Such as 10 for energy sector or 
351010 for "Health Care Equipment & supplies" industry. The codes are fixed even if new 
classifications are added at some point in the future. This means that you won't need to 
change AFL codes even if new classifications are added. But it is important to understand 
that these codes work in hierarchical way. So 

GetCategorySymbols( categoryGICS, 10) 

will return all symbols belonging to energy sector, including those in 10101010 - Oil & Gas 
Drilling sector as well as 10102050 - Coal & Consumable Fuels; for example. See 
http://en.wikipedia.org/wiki/Global_lndustry_Classification_Standard for more details on 
GIGS system 

http://en.wikipedia.org/wiki/lndustry_Classification_Benchmark for more details on ICB 
system 

EXAMPLE CategorySetName( "Testing", categoryWatchList, 1 ); 

SEE ALSO CategoryAddSymbolQ function , CategoryFind() function , CategoryGetName() function , 

CategoryGetSymbolsO function , CategoryRemoveSymbol() function 

References: 


The CategorySetName function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


CategorySetName - set the name of category (group, market, watch list, industry) 
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Indicators 


CCI 

- commodity channel index 

SYNTAX CCI( periods = 14 ) 

CCIa( array, periods = 14 ) 

RETURNS ARRAY 

FUNCTION Calculates the Commodity Channel Index (using periods averaging range ). 

Second version (CCIa) accepts Input array, so CCI can be applied to array different than 
close. (CCIa exists In AFL 2.2+ only (V.4.20+)) 

EXAMPLE CCI(14) 

CCIa(Hlgh, 14); 

SEE ALSO 
Comments: 


Tomasz Janeczko 

CCI uses Internally 'Avg' bullt-ln price array. 

tj -at- 

'Avg' Is also known as typical price: 

amlbroker.com 

Avg = ( H + L + C ) /3 

2003-09-03 04:24:35 

So 

CCI( period ) Is equivalent to CCIa( Avg, period ). 


Therefore If you want to calculate CCI from Foreign ticker you should overwrite Avg 
array. 

Instead of OHLC: 


Avg = ( Forelgn("!VIX", "H") + Forelgn("!VIX", "L") + Forelgn("!VIX", "C")) /3; 
cc = CCI(perlod); 


Alternativelly use CCIa that takes array directly: 


cc = CCIa( Forelgn("!VIX", "H") + Forelgn("!VIX", "L") + Forelgn("!VIX", "C")) / 3, 
period); 


References: 


The CCI function Is used In the following formulas In AFL on-line library: 

• Adaptave Zones 0/B & 0/S Oscillator 

• Auto-Optimizatlon Framework 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI Woodies Style 

• CCI(20) Divergence Indicator 

• CCI/DI+- COMBO Indicator 

• Commodity Channel Index 

• JEEVAN'SSRI CHAKRA 

• Price with Woodies Pivots 


CCI - commodity channel index 
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• RSIS 

• The Stochastic CCI 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodies CCI 

More information: 

Updated on-line reference 


CCI- commodity channel index 
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Math functions 


ceil 

- ceil value 


SYNTAX ceil( number) 
ceil( array) 

RETURNS NUMBER, 
ARRAY 


FUNCTION Calculates the lowest Integer that Is greater than NUMBER or ARRAY. 
EXAMPLE The formula ceil( 6.2) returns 7; the formula ceil(-6.2) returns -6. 

SEE ALSO FLOORO function , INT() function , ROUND() function 

References: 


The ceil function Is used In the following formulas In AFL on-line library: 

• AR_Predlctlon.afl 

• Bullish Percent Index 2 files combined 

• Bullish Percent Index 2004 

• Gann Swing Charts In 3 modes with text 

• JEEVAN'S SRI CHAKRA 

• Market Profile 

• Murrey Math Price Lines 

• N-perlod candlesticks (time compression) 

• P&F Chart - High/Low prices Sept2003 

• P&F chart with range box sizes 

• PF Chart - Close - April 2004 

• Point & figure Chart India Securities 

• Renko Chart 

• Triangle exploration using P&F Chart 

• Trigonometric Fit - TrIgFIt with AR for cos / sin 

More information: 

Updated on-line reference 


ceil - ceil value 
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Chaikin indicators 

- Chaikin osciiiator 


SYNTAX 

chaikin( fast= 9, slow= 14 ) 

RETURNS 

ARRAY 

FUNCTION 

Calculates the Chaikin Oscillator with averaging parameters: fast, slow 

EXAMPLE 



SEE ALSO 
References: 

The Chaikin function is used in the foiiowing formuias in AFL on-line library: 

More information: 

Updated on-line reference 


Chaikin - chaikin oscillator 
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ClipboardGet 

- retrieves current contents of Windows ciipboard 


Miscellaneous functions 

(AFL 2.60) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


ClipboardGetO 

STRING 

Retrieves current contents of Windows ciipboard 

"Contents of the Windows clipboard" + ClipboardGetO; 

CiipboardSetO function 


The ClipboardGet function is used in the foilowing formulas in AFL on-line library: 

More information: 


Updated on-line reference 


ClipboardGet - retrieves current contents of Windows clipboard 
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ClipboardSet Miscellaneous functions 

- copies the text to the Windows ciipboard ^ 


SYNTAX 

ClipboardSet( "Text"); 

RETURNS 

NUMBER 

FUNCTION 

Copies the "text" to the Windows clipboard. 

Returns True (1) on success and 0 on failure 

EXAMPLE 

// this can be used to put dynamically-constructed texts into 
// clipboard 
// 

ClipboardSet ( "The price of " + FullNameO + " is " + Close ); 

SEE ALSO 

ClipboardGetO function 

References: 



The ClipboardSet function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-line reference 


ClipboardSet - copies the text to the Windows clipboard 
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ColorBlend 

- blends (mixes) two colors 


Indicators 

(AFL 3.30) 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


ColorBlend( colorFrom, colorTo, factor = 0.5 ) 

NUMBER 

The function blends (mixes) colorFrom with colorTo with 'factor' proportion using the 
following algorithm 

RGB = ( 1 - factor) * RGB(colorFrom) + factor * RGB(colorTo ); 

So factor = 0 means use colorFrom only, factor = 1 means use colorTo only. All in-between 
values mean create mix of colors. The lower the factor value means more colorFrom. 

This function makes it easy to lighten or darken colors like this: 

function ColorLighten( color ) 

{ 

return ColorBlend ( color, colorWhite, 0.5 ); 

} 


function ColorDarken( color ) 

{ 

return ColorBlend ( color, colorBlack, 0.5 ); 

} 

SEE ALSO ColorRGBO function , ColorHSB() function 

References: 


The ColorBlend function is used in the following formulas in AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Fib Fan Based on ZZ 

• Ichimoku Kinko Hyo 

• Intraday Trend Break System 

More Information: 


Updated on-line reference 


ColorBlend - blends (mixes) two colors 
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ColorHSB 

- specify color using Hue-Saturation-Brightness 


Miscellaneous functions 

(AFL 2.80) 


SYNTAX ColorHSB( hue, saturation, brightness ) 

RETURNS NUMBER 

FUNCTION The function allows to specify color out of 16 million color (24 bit) palette using Hue, 
Saturation and Brightness parameters. 

The return value is a number that can be used in Plot, PlotOHLC, PlotForeign, AddColumn, 
AddTextColumn functions to specify chart or column color. 

Parameters: 


• hue - represents gradation of color within the optical spectrum (as in rainbow) 

• saturation represents "vibrancy" of the color 

• brightness represents brightness. 

Each parameter ranges from 0 to 255, where 0 represents 0% saturation/brightness or 0 
degree hue in HSV color wheel, and 255 represents 100% saturation/brightness or 
360degrees hue in HSV color wheel. 

When you modify hue from 0 to 255 you will see consecutive rainbow colors starting from 
red, through yellow and green to blue and violet. 

For more information about HSB color space please read: 
http://en.wikipedia.org/wiki/HSB_color_space 

EXAMPLE // Example 1: 

// 3-d multicolor multiple moving average cloud chart 
side = 1; 

increment = Param (" Increment ", 2 , 1, 10, 1 ); 

for ( 1 = 10; i < 80; 1=1+ increment ) 


up = MA ( C, 1 ); 

down = MA ( C, 1 + increment ); 


if ( ParamToggle ( "3D effect?", "No|Yes" ) ) 

side = Ilf (up<=down AND Ref ( up<=down, 1 ), 1, 0.6 ); 

PlotOHLC ( up,up,down,down, "MA"+i, ColorHSB ( 3* (1 - 10), 
Param ( "Saturation" , 128, 0, 255 ), 

side * Param ( "Brightness" , 255, 0, 255 ) ), styleCloud | 
styleNoLabel ) ; 

} 


// Example 2: 

/////// 

//Color-parade exploration 


ColorHSB - specify color using Hue-Saturation-Brightness 
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Filter=l; 

for ( i=0; i<256; i=i+16) 

AddColumn ( C, "C", 1.2, colorDefault, ColorHSB ( 
% 256, 255-i, 255 ) ); 

SEE ALSO ColorRGBO function , PLOT() function , AddCoiumn() function 

References: 

The ColorHSB function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Animated BackGround 

• Animated BackGround 1.1 

• Brian Wiid 

• IchimokuBrianVioreiRO 

• Market Profiie 

More information: 

Updated on-line reference 


( Barindex () + i ) 


ColorHSB- specify color using Hue-Saturation-Brightness 
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ColorRGB 

- specify color using Red-Green-Blue components 


Miscellaneous functions 

(AFL 2.80) 


SYNTAX ColorRGB( red, green, blue ) 

RETURNS NUMBER 

FUNCTION The function allows to specify color out of 16 million color (24 bit) palette using Red, Green, 
Blue components. 

The return value is a number that can be used in Plot, PlotOHLC, PlotForeign, AddColumn, 
AddTextColumn functions to specify chart or column color. 


Parameters: 

red, green, blue - represent color component values in range 0..255 each 

For more information about RGB color model please read: 
http://en.wikipedia.org/wiki/RGB_color_model 

EXAMPLE Plot( MA(C,10), "Light Red", ColorRGB( 255, 128, 128 )); Plot( MA(C,20), "Light 

Green", ColorRGB( 128, 255, 128 )); Plot( MA(C,30), "Light Blue", ColorRGB( 128, 128, 255 

)); 

SEE ALSO ColorHSBO function , PLOT() function , AddColumn() function 

References: 


The ColorRGB function is used in the following formulas in AFL on-line library: 

• ALJEHANI 

• Alternative ZIG function 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• Automatic Trendlines using multiple timeframes 

• Channel/S&R and trendlines 

• Continuous Contract Rollover 

• Cycle Period 

• Fib Fan Based on ZZ 

• Heatmap VI 

• Hurst "Like" DE 

• Intraday Range and Periods Framer 

• Meu Sistema de Trading - versao 1.0 

• Multiple Ribbon Demo 

• Perceptron 

• Probability Density & Gaussian Distribution 

• Rebalancing Backtest avoiding leverage 

• TD Sequential 

• VSTOP (2) 

• VSTOP (3) 

• VWAP versus Average Price 

• WILSON RELATIVE PRICE CHANNEL 

• ZLEMA ATR Long Only Trading System 


ColorRGB - specify color using Red-Green-Blue components 
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More information: 

Updated on-line reference 


ColorRGB- specify color using Red-Green-Blue components 
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Correlation Statistical functions 

-correlation (AFL1.4) 


SYNTAX correlation( ARRAY1, ARRAY2, periods ) 

RETURNS ARRAY 

FUNCTION Calculates correlation between ARRAY1 and ARRAY2 using periods range 
For more Information about correlation please check this: 


http://en.wlklpedla.org/wlkl/Correlatlon 

EXAMPLE // the line below calculates 

// Correlation between Close price AND AND Close price 5 days back 
Correlation ( Close, Ref ( Close, -5 ), 5 ); 


// Built-in correlation can be re-coded with 
// basic AFL functions like MA (moving average) - which 
// is equivalent for "expected value" statistic term 
// and few basic arithmetic operations 


function Correl ( x, y, number ) 

{ 

nom= MA ( x * y, number ) - MA ( x, number ) * MA ( y, number ); 
denom = sqrt ( MA ( x ^ 2, number ) - MA ( x, number )'' 2 ) * 
sqrt ( MA ( y ^ 2, number ) - MA ( y, number ) ^ 2 ); 
return nom/denom; 

} 


GraphO=Correlation( C, Ref ( H, -2 ) , 10 ); // built-in 
Graphl=Correl( C, Ref ( H, -2 ) , 10 ) ; // re-coded; 


SEE ALSO 
References: 

The Correlation function Is used In the following formulas In AFL on-line library: 

• Alpha and Beta and R_Squared Indicator 

• correlerror 

• crMathLIb 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Inter-market Yield Linear Regression Divergence 

• R-Squared 

• Trend Exploration: Count Number of New Highs 
More information: 

Updated on-line reference 


Correlation - correlation 
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Correlation - correlation 
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cos Math functions 

- cosine 


SYNTAX cos( NUMBER) 
cos( ARRAY) 

RETURNS NUMBER 
ARRAY 


FUNCTION Returns the cosine of NUMBER or ARRAY. Assumes that the NUMBER or ARRAY values 
are in radians. 

EXAMPLE cos( C ) 

SEE ALSO atan() function , SIN() function 

References: 


The cos function is used in the following formulas in AFL on-line library: 

• AR_Prediction.afl 

• Cybernertic Hilbert Sine Wave 

• Cycle Period 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• John Ehler 

• Luna Phase 

• Sine Wave Indicator 

• Smoothed Adaptive Momentum 

• Stress with SuperSmoother 

• Three Pole Butterworth 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

More information: 

Updated on-line reference 


cos 


cosine 
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cosh 

- hyperbolic cosine function 

SYNTAX cosh( NUMBER) 

cosh( ARRAY) 

RETURNS NUMBER, 

ARRAY 

FUNCTION Returns the hyperbolic cosine of NUMBER or ARRAY. This function assumes that the 
ARRAY values are in radians. 

EXAMPLE 

SEE ALSO 
References: 

The cosh function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


Math functions 

(AFL 2.80) 


cosh - hyperbolic cosine function 
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CreateObject Miscellaneous functions 

- create COM object ^ 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 

SEE ALSO 
References: 


createobject( 

OBJECT 

Creates the instance of "Seruer.C/ass"COM object. The return value should be assigned to a 
variable that is used latter for calling the methods of the object. 

Note: this function creates the instance of the object everytime the formula is executed (the 
object is released automatically at the end of the formula - no explicit freeing is necessary) 

myobj = CreateObject("MyOwnActiveX.CIass1"); 

myobj.Method( 1,2, Close ); // call the method of myobj COM object 

CREATESTATICOBJECTO function 


The CreateObject function is used in the following formulas in AFL on-line library: 

• AFL to Python COM Link 

• AFL-Excel 

• Auto Export to Gif 

• Calculate composites for tickers in list files 

• Chart Zoom 

• Heatmap V1 

• LoadAB.vbs 

• Now Send Push Notifications From Amibroker 

• SectorRSI 


More Information: 


Updated on-line reference 


CreateObject - create COM object 
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CreateStaticObject 
- create static COM object 


Miscellaneous functions 

(AFL 1.8) 


SYNTAX createstaticobject( 
RETURNS OBJECT 


FUNCTION Creates the single static instance (one per AmiBroker session) of "Server.Class" COM 

object. The return value should be assigned to a variable that is used latter for calling the 
methods of the object. This function is useful for "heavyweight" COM object like OuotesPlus 
ActiveX for example. 

Note: this function creates the instance of the object only once when the formula is executed 
for the first time. Then the object is cached internally for all consecutive calls. It is also 
shared if multiple formulas use the same object using CreateStaticObject call. The object is 
automatically released when AmiBroker is closed. 

EXAMPLE myobj = CreateStaticObject("MyOwnActiveX.CIass1"); 

myobj.Method( 1,2, Close ); // call the method of myobj COM object 


SEE ALSO CreateObjectO function 

References: 


The CreateStaticObject function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


CreateStaticObject - create static COM object 
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Cross Trading system toolbox 

- crossover check 


SYNTAX Cross( ARRAY1, ARRAY2 ) 

RETURNS ARRAY 

FUNCTION Gives a "1" or true on the day that ARRAY1 crosses above ARRAY2. Otherwise the resuit is 
" 0 ". 

To find out when ARRAY1 crosses below ARRAY2, use the formuia cross(ARRAY2, 
ARRAY1) 


EXAMPLE cross( dose, ema(ciose,9)) 

SEE ALSO 
References: 


The Cross function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Adaptive Centre of Gravity 

• Adaptive Cyber Cycie 

• Adaptive Reiative Vigour Index 

• AFL Example 

• AFL Example - Enhanced 

• AFL-Excel 

• Against all odds 

• ALJEHANI 

• Aroon The Advisor 

• AR_Prediction.afl 

• ATR Study 

• Auto-Optimization Framework 

• automatic trendlines using fractal patterns 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Awsome Oscilator 

• Basket Trading System T101 

• Bow tie 

• Brian Wild 

• Bull Fear / Bear Fear 

• Candlestick Comentary-Help needed 

• CCI(20) Divergence Indicator 

• Centre of Gravity 

• Chandelier Exit 

• Chandelier Exit 

• Chandelier Exit or Advanced Trailing Stop 

• Channel/S&R and trendlines 

• com-out 

• Commodity Channel Index 

• Connors TPS 

• correlerror 

• Customised Avg. Profit %, Avg. Loss % etc 

• Cyber Cycle 

• DateNum DateStr 


Cross - crossover check 
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• Demand Index 

• Dinapoli Guru Commentary 

• DMI Spread Index 

• Dynamic Momentum Index 

• Dynamic Momentum Index 

• Dynamtic Momentum Index 

• Ed Seykota's TSP: EMA Crossover System 

• Effective Swing Indicator 

• ekeko price chart 

• Ema bands 

• EMA Crossover 

• Enveiope System 

• FastStochK FuiiStochK-D 

• Fisher Centre of Gravity 

• Fisher Cyber Cycie 

• Fisher Osciiiator 

• Fisher Reiative Vigour Index 

• Follow the Leader 

• Fund Screener 

• Gann HiLo Indicator and System 

• Gann Swing chart v41212 

• hassan 

• Heatmap V1 

• Heikin Ashi Delta 

• Hilbert Sine Wave Support & Resistance 

• ICHIMOKU SIGNAL TRADER 

• IchimokuBrianVioreIRO 

• Index and ETF trading 

• Indicator Explorer (ZigZag) 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• Lagging MA-Xover 

• Last Five Trades Result Dashboard - AFL code 

• MACD commentary 

• MACD optimize 

• Meu Sistema de Trading - versao 1.0 

• mitalpradip 

• Modified Head & Shoulder Pattern 

• Multiple Ribbon Demo 

• Performance Check 

• Plot the Equity Curve without Backtesting? 

• prakash 

• PVT Trend Decider 

• regavg 

• Relative Momentum Index (RMI) 

• Relative Strength Index 

• Relative Vigour Index 

• Reverse MFI Crossover 

• Rl - Auto Trading System 

• RUTVOL timing signal with BB Scoring routine 

• Sainath Sidgiddi 

• Scale Out: Futures 


Cross - crossover check 
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• Sine Wave Indicator 

• STO & MACD Buy Signais with Money-Management 

• Stochastic Centre of Gravity 

• Stochastic Cyber Cycie 

• Stochastic Fast%K and Fuii 

• Stochastic optimize 

• Stochastic Relative Vigour Index 

• Stochastic RSI 

• Stochastics Trendlines 

• Stock price Alertif 

• Stops Implementation in AFS 

• Stops on percentages 

• Stress with SuperSmoother 

• Support and Resistance 

• swing chart 

• TD Moving Average 2 

• The D_oscillator 

• Trailing Stop Loss 

• Trend Analysis_Comentary 

• Trend exploration with multiple timeframes 

• Trend Exploration: Slope Moving Average 

• Trend Following System 

• Trend Trigger Factor 

• TrendingRibbonArrowsADX 

• Triangular Moving Average new 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Using From and To dates from Auto Analysis in Code 

• VAMA 

• Visualization of stoploses and profit in chart 

• Vivek Jain 

• Volatility 

• Volatility Breakout with Bollinger Bands 

• Volume Occilator 

• Volume Oscillator 

• Williams Alligator system 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


Cross- crossover check 
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Moving averages, summation 


Cum 

- cumulative sum 


SYNTAX Cum( ARRAY) 

Cum( Vaiue) 

RETURNS ARRAY 

FUNCTiON Calculates a cumulative sum of the ARRAY from the first period In the chart. 

Note: Starting from AmiBroker 5.30, the Cum() function does NOT force using all bars. In the 
past versions Cum() functions effectively turned OFF OulckAFL feature by requesting all bars 
to be processed. Since Cum() function was popular It caused that many legacy formulas that 
used It were not benefiting from OulckAFL. 

To enable OulckAFL with such formulas now Cum() function does NOT affect required bars 
count (previously It forced all bars). 

This change may lead to different results when comparing with old versions. If you are 
Interested In getting old behaviour and use all bars just add: 

SetBarsRequlred( sbrAII) 


anywhere In your formula. 


EXAMPLE The formula cum( 1) calculates an Indicator that rises one point for each day since the 

beginning of the chart - this Is an equivalent of bar number - especially useful If you want to 
detect the last bar: ThIsIsLastBar = cum( 1 ) == lastvalue( cum( 1 )); 

SEE ALSO SUM() function 

Comments: 


Graham Kavanagh 

Sum adds up the last "n" number of bars. It sums whatever you put Into the first 

gkavanagh@e-wlre.net.au 

part of the sum formula. 

2004-08-09 07:49:35 

Cum(1) adds 1 to the previous value of Cum, so the first bar Is 1 and It just 
keeps adding one to the last bar value of cum(1). 

You can use Cum to add anything, like how many times you get rising days In 
the entire chart: 


Rise = C>0; //this gives results of 0 or 1 

TotalRIse = Cum(Rlse); 


You could limit this as well to time periods, or any other condition Example 
would be one for total rise days since 1995: 


RecentRlse = C>0 and Year()>=1995; //this gives results of 0 or 1 

TotalRIse = Cum(RecentRlse); 


If you wanted to know how many rising days In the last 12 bars you would use: 

Cum - cumulative sum 
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LastRises = Sum(Rise,12); 

Hope this helps 

References: 

The Cum function is used in the following formulas in AFL on-line library: 

• AR_Prediction.afl 

• Auto-Optimization Framework 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic Trend-line 

• automatic trendlines using fractal patterns 

• Baseline Relative Performance Watchlist charts V2 

• Buff Volume Weighted Moving Averages 

• Bullish Percent Index 2 files combined 

• Candle Stick Analysis 

• Color Display.afl 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Dave Landry PullBack Scan 

• Demand Index 

• Double top detection 

• ekeko price chart 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Fib Fan Based on ZZ 

• Fibonacci Internal and External Retracements 

• Fre 

• Fund Screener 

• Gann Swing Chart 

• Head & Shoulders Pattern 

• Hurst Constant 

• Intraday Fibonacii Trend Break System 

• Last Five Trades Result Dashboard - AFL code 

• Linear Regression Line & Bands 

• Linear Regression Line w/ Std Deviation Channels 

• McClellan Summation Index 

• Modified Head & Shoulder Pattern 

• Modified Momentum Finder DDT-NB 

• Modified-DVI 

• Monthly bar chart 

• Moving Average "Crash" Test 

• Multiple sinus noised 

• N-period candlesticks (time compression) 

• nth (1 - 8 ) Order Polynomial Fit 

• Pattern Recognition Exploration 

• Prashanth 

• Price Persistency 

• Projection Oscillator 

• PVT Trend Decider 


Cum- cumulative sum 
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• QP2 Float Analysis 

• R-Squared 

• Random Walk 

• Regression Analysis Line 

• RSI Trendlines and Wedges 

• RSIS 

• Square of Nine Roadmap Charts 

• Steve Woods' Cum. Vol. Float + Cum. Vol. Channels 

• Steve Woods' Cumulative Vol. Percentage Indicator 

• Stochastics Trendlines 

• TD Sequential 

• Trend Exploration: Count Number of New Highs 

• Triangle exploration using P&F Chart 

• Triangular Moving Average 

• Triangular Moving Average new 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Volatility Quality Index 

• Weekly chart 

• Williams Alligator system 

More information: 

Updated on-line reference 


Cum- cumulative sum 
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Date 
- date 


Date/Time 

(AFL 1.1) 


SYNTAX dateO 

RETURNS STRING 

FUNCTION It is used to display the selected date in commentary / interpretation window 

EXAMPLE dateO 

SEE ALSO 
References: 


The Date function is used in the following formulas in AFL on-line library: 

• AccuT rack 

• ADX Indicator - Colored 

• AFL Example 

• AFL Example - Enhanced 

• AFLGIossaryl 

• Against all odds 

• Another Fib Level 

• Bullish Percent Index 2004 

• Candle Stick Demo 

• candlestick chart for Volume/RSI/OBV 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI Woodies Style 

• Chart Zoom 

• Color Coded Short Term Reversal Signals 

• Commodity Channel Index 

• Congestions detection 

• Continuous Contract Rollover 

• DateNum_DateStr 

• Dinapoli Guru Commentary 

• Double Smoothed Stochastic from W.Bressert 

• Elder safe Zone Long + short 

• Elder Triple Screen Trading System 

• Elder's SafeZone Stop 

• ElderSafeZoneStopLong 

• ElderSafeZoneStopShort 

• EMA Crossover Price 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Futures - Dollar Move Indicator 

• Futures - Dollar Move Today Indicator 

• hassan 

• Heikin Ashi Candles 

• Heinkin-Ashi 


Date - date 
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• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• JEEVAN'S SRI CHAKRA 

• Last Five Trades Result Dashboard - AFL code 

• lastNDaysBeforeDate 

• MA Difference 20 Period 

• MACD commentary 

• MACD Histogram - Change in Direction 

• Main price chart with Rainbow & SAR 

• Market Facilitation Index VS Volume 

• MFE and MAE and plot trades as indicator 

• Nick 

• PF Chart - Close - April 2004 

• Pivot Point and Support and Resistance Points 

• Pivots for Intraday Forex Charts 

• Plot the Equity Curve without Backtesting? 

• Position Sizing and Risk Price Graph 

• Position Sizing and Risk Price Graph - 2 

• Price with Woodies Pivots 

• Probability Calculator 

• Relative Strength Index 

• Relative Strength Multichart of up to 10 tickers 

• Remove EOD data from intraday database 

• Shares To Buy Price Graph 

• Super Trend Indicator 

• Support Resistance levels 

• Trading ATR 10-1 

• Triangular Moving Average new 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

• Woodies CCI 

• Zig Zag Indicator with Valid Entry and Exit Points 

• ZigZag Retracements 

More information: 

Updated on-line reference 


Date- date 
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DateNum 
- date number 


SYNTAX datenumO 

RETURNS ARRAY 

FUNCTION Returns the array with numbers that represent quotation dates coded as foiiows: 

10000 * (year - 1900) + 100 * month + day, so 2001-12-31 becomes 1011231 and 
1995-12-31 becomes 951231 

EXAMPLE datenumO; 

SEE ALSO 
References: 


The DateNum function is used in the foiiowing formuias in AFL on-iine iibrary: 

• BEANS-Summary of Hoidings 

• Buiiish Percent Index 2004 

• Continuous Contract Roiiover 

• DateNumDateStr 

• Date_To_Num(), Time_To_Num() 

• Fund Screener 

• Gordon Rose 

• IBD reiative strength database ranker 

• IBD relative strength database Viewer 

• Intraday Range and Periods Framer 

• lastNDaysBeforeDate 

• MDYtoXLSerialDays and XLSerialDaysToDateNum 

• MFE and MAE and plot trades as indicator 

• PF Chart - Close - April 2004 

• Rea Time Daily Price Levels 

• Steve Woods' Cum. Vol. Float + Cum. Vol. Channels 

• Steve Woods' Cumulative Vol. Percentage Indicator 

• suresh 

• TWS auto-export Executions-file parser 

• Weekly chart 

• Zig Zag Indicator with Valid Entry and Exit Points 
More information: 

Updated on-line reference 


Date/Time 

(AFL 1.4) 


DateNum - date number 
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DateTime 

- retrieves encoded date time 


Date/Time 

(AFL 2.3) 


SYNTAX DateTimeO 

RETURNS ARRAY 

FUNCTION Returns array of encoded date/time values suitable for using with AddColumn and 

formatDateTime constant to produce date time formated according to your system settings. 


VERSION 5.27 and above: It is important to understand that DateTime is not a simple 
number but rather bitset and two datetime values can only be reliably compared for equiity or 
inequality using == or != operators. Any other comparisions (less than/greater then) using 
normal operators > < can lead to wrong results, therefore to compare two datetime numbers 
you should use DateTimeDiff( arg1, arg2 ) which will return positive values if arg1 > arg2 and 
negative values if arg1 < arg2. 

EXAMPLE 1. Simple date/time column 


AddColumn ( DateTimeO, "Date / Time", formatDateTime ); 


2. Example (produces signal file accepted by various other programs): 


BuY=Cross(MACD(),Signal()); 

Sell=Cross(Signal(), MACD()); 

Filter=Buy OR Sell; 

SetOption("NoDefaultColumns", True ); 

AddColumn ( DateTimeO, "Date", formatDateTime ); 
AddColumn( Ilf( Buy, 66, 83 ), "Signal", formatChar ); 


SEE ALSO 
References: 


The DateTime function is used in the following formulas in AFL on-line library: 

• AFL_Glossary_1 

• AutoTrade using an Exploration 

• babaloo chapora 

• BEANS-Summary of Holdings 

• Chart Zoom 

• Congestions detection 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Futures - Dollar Move Indicator 

• Gann Swing Charts in 3 modes with text 

• Gordon Rose 

• IBD relative strength database ranker 

• Improved NH-NH scan / indicator 

• Intraday Range and Periods Framer 

• PF Chart - Close - April 2004 

• Pivot Finder 


DateTime - retrieves encoded date time 
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• Relative Strength Multichart of up to 10 tickers 

• Scale Out: Futures 

• shailu lunia 

• Trend Exploration: Count Number of New Highs 

• Trend Exploration: Slope Moving Average 

• TWS trade plotter 

• ValueChart 

More information: 

Updated on-line reference 


DateTime- retrieves encoded date time 
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DateTimeAdd 

- adds specified number of seconds/minutes/hours/days to datetime 


Date/Time 

(AFL 3.40) 


SYNTAX DateTimeAdd( datetime, amount, interval = inDaily) 

RETURNS NUMBER or ARRAY 

FUNCTION The function adds specified amount of 'intervais' to input datetime array. Aiiows for exampie 
to caicuiate datetime 5 days back or 13 months into the future. 

INPUT: 

• datetime - scalar or array - the datetime value to add to (for example returned by 
Now(), DateTimeO or StrToDateTime/_DT or ConvertDateTime functions) 

• amount - number of 'intervals' to add (seconds/minutes/hours/days/etc - depending 
on interval parameter) 

• interval - specifies unit you want to add, supported units are ini Second, ini Minute, 
inHourly, inDaily, inWeekly, inMonthly, inQuarterly, inYearly 

RETURNS: 

datetime (scalar or array) - returned type depends on input 

EXAMPLE // Example 1: 

X = Now ( 5 ) ; 

print! ("11 days from now " + DateTimeToStr ( DateTimeAdd( x, 11, 

inDaily ) ) ) ; 

// Example 2 (commentary): 

X = Now ( 5 ); 

print! ( " now is " + DateTimeToStr ( x ) ); 

for ( shift = -12; shift <= 12; shift++ ) 

{ 

print! ("%g seconds from now is " + DateTimeToStr ( DateTimeAdd ( x, 
shift, 1 ) ) + "n", shift ); 

print! ("%g minutes from now is " + DateTimeToStr ( DateTimeAdd ( x, 
shift, inlMinute ) ) + "n", shift ); 

print! ("%g hours from now is " + DateTimeToStr ( DateTimeAdd ( x, 
shift, inHourly ) ) + "n", shift ); 

print! ("%g days from now is " + DateTimeToStr ( DateTimeAdd ( x, 
shift, inDaily ) ) + "n", shift ); 

print! ("%g weeks from now is " + DateTimeToStr ( DateTimeAdd ( x, 
shift, inWeekly ) ) + "n", shift ); 

print! ("%g months from now is " + DateTimeToStr ( DateTimeAdd ( x, 
shift, inMonthly ) ) + "n", shift ); 

print! ("%g quarters from now is " + DateTimeToStr ( DateTimeAdd ( x, 
shift, inQuarterly ) ) + "n", shift ); 

print! ("%g years from now is " + DateTimeToStr ( DateTimeAdd ( x, 
shift, inYearly ) ) + "nn", shift ); 


DateTimeAdd - adds specified number of seconds/minutes/hours/days to datetime 
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] 

SEE ALSO DateTimeDiffO function , DateTimeToStr() function , DateTimeConvert() function , 
DateTimeO function 

References: 

The DateTimeAdd function is used in the foiiowing formuias in AFL on-line library: 

More information: 

Updated on-line reference 


DateTimeAdd- adds specified number of seconds/minutes/hours/days to datetime 
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DateTimeConvert 
- date/time format conversion 

SYNTAX DateTimeConvert( format, date, time = Null) 

RETURNS NUMBER or ARRAY 

FUNCTION The function allows to convert from DateTime format to DateNum and TimeNum and vice 
versa. 

format parameter controls the direction of conversion: 

• format = 0 - converts DateTime format to DateNum format, example 

mydatenum = DateTimeConvert( 0, DateTimeQ );// - this returns DateNum 

date argument should be in datetime formattime argument in this case should not be 

used 

• format = 1 - converts DateTime format to TimeNum format, example: 

mytimenum = DateTimeConvert( 1, DateTime()); // - returns timenum 

date argument should be in datetime formattime argument in this case should not be 

used 

• format = 2 - converts from DateNum and optionally TimeNum to DateTime format, 
example: 

mydatetime = DateTimeConvert( 2, DateNumQ, TimeNum()); 

date argument should be in datenum formattime argument (optional) should be in 

timenum format. In case of EOD data you can skip time argument: 

mydatetime = DateTimeConvert( 2, DateNumQ ); 

• format = 3 - (AB5.0 or higher) converts DateTime format to Seconds (00..59) 
example: 

myseconds = DateTimeConvert( 3, DateTimeQ ); 

date argument should be in datetime, formattime argument in this case should not be 
used 

• format = 4 - (AB5.0 or higher) converts DateTime format to Minutes(00..59) example: 
myminute = DateTimeConvert( 4, DateTimeQ ); 

date argument should be in datetime, formattime argument in this case should not be 
used 

• format = 5 - (AB5.0 or higher) converts DateTime format to Hours (00..23) example: 
myhour = DateTimeConvert( 5, DateTimeQ ); 

date argument should be in datetime, formattime argument in this case should not be 
used 


Date/Time 

(AFL 2.90) 


EXAMPLE 


DateTimeConvert - date/time format conversion 
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SEE ALSO 

mydatenum = DateTimeConvert ( 0, DateTimeO ); // - this returns 

DateNum 

mytimenum = DateTimeConvert ( 1, DateTimeO ); // - returns timenum 
mydatetime = DateTimeConvert! 2, DateNumO, TimeNumO ); 
mydatetime = DateTimeConvert! 2, DateNum!) ); 

DateNumQ function , DateTimeO function , DateTimeToStrQ function , Day() function , 
DayOfWeekO function , DayOfYear() function , TIMENUM() function , MONTH() function , 
YEAR() function , HOUR() function , MINUTE() function , SECOND() function 

References: 



The DateTimeConvert function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-iine reference 


DateTimeConvert- date/time format conversion 
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DateTimeDiff 

- get difference in seconds between two datetime vaiues 


Date/Time 

(AFL 3.30) 


SYNTAX DateTimeDiff( arg1, arg2 ) 

RETURNS NUMBER or ARRAY 

FUNCTION DateTimeDiff( arg1, arg2 ) which will return positive values if arg1 > arg2 and negative values 
if arg1 < arg2. 

The difference is given in seconds. 


The function can operate on scalar and array arguments, returning scalar if both inputs are 
scalars, and array otherwise. 

It is important to understand that DateTime is not a simple number but rather bitset and two 
datetime values can only be reliably compared for equiity or inequality using == or != 
operators. Any other comparisions (less than/greater then), using normal operators > < may 
sometimes lead to wrong results (if one of dates compared is pre-1964), therefore to 
compare two datetime numbers reliably you should use DateTimeDiff. 


EXAMPLE 

SEE ALSO DateTimeO function 

References: 


The DateTimeDiff function is used in the following formulas in AFL on-line library: 
• Improved NH-NH scan / indicator 

More information: 


Updated on-line reference 


DateTimeDiff - get difference in seconds between two datetime values 
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DateTimeToStr 
- convert datetime to string 


String manipulation 

(AFL 2.8) 


SYNTAX DateTimeToStr( NUMBER) 


RETURNS STRING 


FUNCTION Converts number representing date/time value (for example obtained using 

GetCursorXPositionO, Now(), DateTime() functions) to the corresponding STRING (text). 


EXAMPLE ToolTip="X="+DateTimeToStr (GetCursorXPosition ()) 
+"nY="+GetCursorYPosition (); 


SEE ALSO DATETIMEO function , NOW() function , StrToDateTime() function 

References: 

The DateTimeToStr function is used in the following formulas in AFL on-line library: 

• AFLGIossaryt 

• AutoTrade using an Exploration 

• Chart Zoom 

• Congestions detection 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Gann Swing Charts in 3 modes with text 

• GFX ToolTip 

• Scale Out: Futures 

More information: 

Updated on-line reference 
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Date/Time 

(AFL 1.4) 


SYNTAX 

dayO 

RETURNS 

ARRAY 

FUNCTiON 

Returns the array with days (1 -31) 

EXAMPLE 

writeif( day() < 3, "Beginning of the month", "The rest of the month") 

SEE ALSO 


References: 



The Day function is used in the foilowing formuias in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• Auto Trade Step by Step 

• changing period moving average 

• CoinToss ver 1 

• Daily Fligh Low in Advance 

• Days to Third Friday 

• Expiry day/days - Last thursday of month 

• Expiry Thursday for Indian markets 

• Export All Daily Data to TXT with MS import format 

• Export EOD or Intraday to .csv file 

• Export Intraday Data 

• Heatmap V1 

• Intraday Average Volume 

• IntraDay Open Marker 

• Intraday Strength 

• Intraday Volume EMA 

• Luna Phase 

• Lunar Phases - original 

• LunarPhase 

• Market Profile 

• N-period candlesticks (time compression) 

• Next Date Format 

• Option Calls, Puts and days till third friday. 

• Positive Bars Percentage 

• Relative Strength Multichart of up to 10 tickers 

• Trade day of month 

• VWAP - Volume Weighted Average Price 

• VWAP with standard deviation bands 

• Wolfe Wave Patterns 

More information: 

Updated on-line reference 


Day 

- day of month 


Day - day of month 
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DayOfWeek 
- day of week 


Date/Time 

(AFL 1.4) 


SYNTAX dayofweekO 


RETURNS ARRAY 


FUNCTION Returns the array with day of week (0-6): 


0 - Sunday 
1 - Monday 


5 - Friday 
6- Saturday 


EXAMPLE buy = dayofweek() == 1 ; // buy on Monday 
seil = dayofweekO == 5; // sell on Friday 


SEE ALSO 
References: 

The DayOfWeek function is used in the following formulas in AFL on-line library: 

• Basket Trading System T101 

• Days to Third Friday 

• Ed Seykota's TSP: EMA Crossover System 

• Expiry day/days - Last thursday of month 

• Expiry Thursday for Indian markets 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• MO_CrashZone 

• Option Calls, Puts and days till third friday. 

• RSI of Weekly Price Array 

• Sainath Sidgiddi 

• Stochastic of Weekly Price Array 

• Time Frame Weekly Bars 

• Weekly chart 

• Weekly Trend in Daily Graph 
More information: 

Updated on-line reference 


DayOfWeek - day of week 
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DayOfYear 

- get ordinal number of day in a year 


SYNTAX 

DayOfYearO 

RETURNS 

ARRAY 

FUNCTiON 

Returns the calendar day number counting from beginning of the year January 1st is 1 
Maximum number returned is 366 

EXAMPLE 

Filter=l; 

AddColumn(DayOfYear0, "Day of Year"); 

SEE ALSO 

DAYOFWEEKO function 

References: 



The DayOfYear function is used in the foiiowing formuias in AFL on-iine iibrary: 

• End Of Year Trading 
More information: 

Updated on-line reference 


Date/Time 

(AFL 2.4) 


DayOfYear - get ordinal number of day in a year 
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DaysSince1900 

- get number of days since January 1st, 1900 


Date/Time 

(AFL 3.20) 


SYNTAX DaysSince1900() 

RETURNS ARRAY 

FUNCTION The function returns the number of days that passed since January 1st, 1900, counting from 
2. January 1, 1900 is seriai number 2, and January 1,2008 is seriai number 39448. 

Technicaiiy is equai to Windows OLEDATE and Excei's DATEVALUE function. As to why it 
starts counting from 2 (two) - it is to get the same vaiues as Excei DATEVALUE. Excei's 
DATEVALUE function starts counting from one but it includes Feb 29, 1900 which did not 
exist and this adds extra one day for all dates starting from Mar 1st, 1900. 

The function can be used for calculations that involve calendar days as opposed to trading 
days and replaces previously proposed AFL solution 
http://www.amibroker.eom/kb/2007/03/15/calendar-day-index/ 

Now RefDays can be implemeted as follows (see example) 

EXAMPLE 

SetBarsRequired { 365, 0 ) ; 
function RefDays{ Array, Days ) 

{ 

td = DaysSincel900 {); 
result = Null; 


if { Days < 0 ) 

{ 

f or ( i = BarCount -1; i >= -Days; i = i - 1 ) 

{ 

backday = td[ i ] + Days; // Days is negative 
for { j = -Days/2; j < i; j++ ) 

{ 

if{ td[ i - j ] <= backday ) 

{ 

result [ i ] = Array[ i - j ]; 

break; 


} 

return result; 


} 


Plot { C, "C", colorRed ); 

Plot { Ref { C, -252 ), "Close 252 bars back", colorBlue ); 

Plot ( RefDays{ C, -365 ), "Close 365 days back", colorGreen ); 

SEE ALSO Date() function , DateNum() function , DateTime() function , DateTimeConvert() function 


DaysSincel900 - get number of days since January 1st, 1900 
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References: 

The DaysSince1900 function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-line reference 


DaysSinee 1900- get number of days since January 1st, 1900 
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Decissues 
- declining issues 


Composites 

(AFL 1.2) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


DecIssuesO 

ARRAY 

Returns the number of declining issues for a given market (the one that currently analysed 
stock belongs to) 

DecIssuesO 


The Decissues function is used in the following formulas in AFL on-line library: 

• Absolute Breadth Index 

• Breadth Thrust 

• McClellan Oscillator 

• McClellan Summation Index 


More information: 

Updated on-line reference 


Decissues - declining issues 
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DecVolume 

- declining issues volume 


Composites 

(AFL 1.2) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


DecVolumeQ 

ARRAY 

Returns the volume of declining issues for a given market (the one that currently analysed 
stock belongs to) 

DecVolumeO 


The DecVolume function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


DecVolume - declining issues volume 
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DEMA 

- double exponential moving average 


Moving averages, summation 

(AFL 2.0) 


SYNTAX dema( ARRAY, periods ) 

RETURNS ARRAY 

FUNCTiON Calculates double exponentially smoothed average - DEMA. The function accepts 
time-variable periods. 

EXAMPLE DEMA( Close, 5 ) 

SEE ALSO MA(), EMA(), WMA(), TEMA() 

Comments: 


Tomasz 

Janeczko 

tj -at- 

amlbroker.com 

2003-02-06 

13:51:31 

DEMA can be Implemented via EMA: 

Len=10; 

GraphO= 2 * EMA( C, len ) - EMA( EMA( C, len ), Len ); 

// for comparison only 

Graph1=DEMA(C,Len); 

Tomasz 

Janeczko 

tj -at- 

amlbroker.com 

2003-04-27 

15:43:17 

Note to the comment above: 

EMA and DEMA use different Initialization method. DEMA[ 0 ] Is Initialized with first value 
of Input array, while EMA[ len ] Is Initialized with simple moving average to match output 
with Metastock. 

Therefore they will converge at 2 * Len bars from GraphO start ( 6 * Len bars since 
beginning of the data). 

Tomasz 

Janeczko 

tj -at- 

amlbroker.com 

2003-04-27 

15:48:11 

DEMA can also be Implemented using new for looping: 

Len = 20; 

Plot( DEMA( Close, Len ), "Built-In DEMA", colorRed ); 

factor = 2 / (Len + 1 ); 

el = e2 = Close[ 0 ]; // Initialize 

for( 1 = 0; 1 < BarCount; l-n-) 

{ 

el = factor * Close[ 1 ] h- (1 - factor) * el; 
e2 = factor * el -i- (1 - factor) * e2; 

myDema[ 1 ] = 2 * el - e2; 

} 

Plot( myDema, "Dema In loop", colorBlue ); 

Tomasz 

Janeczko 

tj -at- 

... and can be Implemented using AMA: 

Len = 20; 


DEMA - double exponential moving average 
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amibroker.com 

2003-04-27 

15:51:03 

Factor = 2/(Len-i-1); 

el = AMA( Close, Factor); 
e2 = AMA( el, Factor); 

Plot( DEMA( Close, Len ), "Built-in DEMA", colorRed ); 

Plot( 2*e1 - e2, "AMA-implemened DEMA", colorBlue ); 

Tomasz 

Janeczko 

tj -at- 

amibroker.com 

2003-04-27 

16:26:06 

For more information on DEMA see: 

Stocks & Commodities V. 12:1 (11-19): Smoothing Data With Faster Moving Averages 
by Patrick G. Mulloy. 


References: 


The DEMA function is used in the foiiowing formuias in AFL on-iine iibrary: 

• AFL to Python COM Link 

• Auto-Optimization Framework 

• Average Price Crossover 

• babaioo chapora 
• DEBAJ 

• Dynamic Momentum Index 

• Dynamic Momentum Index 

• Hull with DEMA 

• JEEVAN'SSRI CHAKRA 

• Lagging MA-Xover 

• Moving Averages NoX 

• Support Resistance levels 

• The D_oscillator 

• The Saturation Indicator D_sat 

• Trend Detection 

More information: 

Updated on-line reference 


DEMA- double exponential moving average 
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EMA Moving averages, summation 

- exponential moving average 


SYNTAX 
RETURNS 
FUNCTiON 
EXAMPLE 
SEE ALSO 

Comments: 


ema( ARRAY, periods) 

ARRAY 

Calculates a periods exponential moving average of ARRAY 
ema( close, 5) 

MA() function , TEMA() function , AMA() function , AMA2() function , DEMA() function , 
WMA() function , WILDERS() function 


Nigei Rowe 

rho@blgpond.com 

2003-04-27 

18:05:14 


See the comments attached to DEMA for a discussion on the differences In the way 
EMA and others are Initialised. 

EMA Is Initialised from a simple MA of equivalent length. (For compatablllty with some 
other strange TA software.) The others are Initialised from the first value. 


References: 


The EMA function Is used In the following formulas In AFL on-line library: 

• accum/dlst mov avg crossover SAR 

• AccuT rack 

• Advanced MA system 

• ADXbuy 

• AFL Example 

• AFL Example - Enhanced 

• AFL to Python COM Link 

• Against all odds 

• Andrews PltchforkV3.3 

• AR_Predlctlon.afl 

• ATR Study 

• Auto Trader Basic Flow 

• Auto-Optimizatlon Framework 

• Average Price Crossover 

• babaloo chapora 

• Bad Tick Trim on 5 sec database 

• Balance of Power 

• balance of power 

• BB squeeze 

• BMTRIX Intermediate Term Market Trend Indicator 

• Bollinger - Keltner Bands 

• Bollinger band normalization 

• Breadth Thrust 

• Bull/Bear Volume 

• candlestick chart for Volume/RSI/OBV 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 


EMA - exponential moving average 
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• CCI Woodies Style 

• CCT FibAccordion 

• CCT Kaleidoscope 

• Chaikin's Volatility 

• Chandelier Exit 

• Color Price Bar - Impulse System 

• Compare Sectors against Tickers 

• Connors TPS 

• Coppock Curve 

• Coppock Histogram 

• Dahl Oscillator modified 

• Dave Landry PullBack Scan 

• Dave Landry Pullbacks 

• DEBAJ 

• Demand Index 

• Demand Index 

• Derivative Oscillator 

• Divergences 

• Double Smoothed Stochastic from W.Bressert 

• DT Oscillator 

• Dynamic Momentum Index 

• Dynamic Momentum Index 

• Dynamtic Momentum Index 

• Effective Swing Indicator 

• Elder Bear Power 

• Elder Bull Power 

• Elder Impulse Indicator 

• Elder Impulse Indicator V2 

• Elder Ray - Bull Bear 

• Elder Ray Oscillator with MA 

• Elder Triple Screen Trading System 

• Elder's Market Thermometer 

• Elliott Wave Oscillator 

• Ema bands 

• EMA Crossover 

• EMA Crossover Price 

• Ergodic Oscillator 

• Fibonacci Moving averages 

• Force index 

• Fund Screener 

• Gann Swing Charts in 3 modes with text 

• Heatmap V1 

• Heikin Ashi Delta 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• Heinkin-Ashi 

• Hilbert Study 

• Hull Multiple Moving Averages 

• Hull with DEMA 

• ICHIMOKU SIGNAL TRADER 

• Index and ETF trading 

• Inter-market Yield Linear Regression Divergence 

• INTRADAY HEIKIN ASHI new 


EMA - exponential moving average 
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• JEEVAN'S SRI CHAKRA 

• Lagging MA-Xover 

• MACD Histogram - Change in Direction 

• Market Direction 

• McCleiian Oscillator 

• McClellan Summation Index 

• Meu Sistema de Trading - versao 1.0 

• mfimacd 

• MOCS 

• Modified-DVI 

• Moving Averages NoX 

• Multicycle 1.0 

• Multiple Ribbon Demo 

• NoorDoodie 

• Percentage Price Oscillator 

• Peterson 

• Pivots for Intraday Forex Charts 

• Plot the Equity Curve without Backtesting? 

• Polarized Fractal Efficiency 

• Price with Woodies Pivots 

• Relative Strength 

• Reverse EMA function 

• RSI + Avgs 

• RSIS 

• RUTVOL timing signal with BB Scoring routine 

• Schiff Lines 

• Sector Tracking 

• SectorRSI 

• SF Entry,Stop, PT Indicator 

• shailu lunia 

• SIROC Momentum 

• STD_STK Multi 

• STO & MACD Buy Signals with Money-Management 

• Stochastic %J - KDJ 

• Stochastic of Weekly Price Array 

• StochD_StochK Single.afl 

• Sun&Cloud 

• Support Resistance levels 

• T3 

• T3 Function 

• TAZ Trading Method Exploration 

• The D_oscillator 

• The Relative Slope 

• The Relative Slope Pivots 

• The Saturation Indicator D_sat 

• tomy_frenchy 

• Trend Detection 

• Triangular Moving Average new 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• TRIX 

• TTM Squeeze 

• Varexiist 


EMA - exponential moving average 
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• Vertical Horizontal Filter (VHF) 

• Vivek Jain 

• Volatility 

• Volume Occilator 

• Volume Oscillator 

• Weekly Trend in Daily Graph 

• Weinberg's The Range Indicator 

• William's Alligator System II 

• Williams Alligator system 

• WILSON RELATIVE PRICE CHANNEL 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Heikin-Ashi Panel 

• Woodie's Price Panel With Woodie's Pivots 

• z-distance from vwap 

• ZeroLag MACD(p,q,r) 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


EM A- exponential moving average 
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EnableRotationalT rading 

- Turns on rotational-trading mode of the backtester 


Trading system toolbox 

(AFL 2.5) 


SYNTAX EnableRotationalTradingO 

RETURNS NOTHING 

FUNCTION When placed on the top of system formula it turns on rotational-trading (aka. fund-switching) 
mode of the backtester. 

Note: this function is now marked as obsolete. Use SetBacktestMode( backtestRotational) in 
new formulas. 

IMPORTANT NOTE: Unless vou specifically want to implement fund-switchino/rotational 

trading system you should NOT use this mode. 

Rotational trading is popular method for trading mutual funds. It is also known as 
fund-switching or scoring&ranking. Its basic permise is to rotate symbols all the time so 
only top N issues ranked according to some user-definable score are traded. The number of 
positions open depend on "Max. open positions" setting and available funds / position size. 
Once position is entered in remains in place until security's rank drops below WorstRankHeld 
(settable via SetOption("WorstRankHeld", 5 ) ). Regular buy/sell/short/cover signals are 
not used at all. 

The rotational mode uses only score variable (PositionScore) to rank and rotate securities. 
This idea has been implemented earlier in PortfolioTrader AFL formula written by Fred 
Tonetti with GUI written by Dale Wingo. 

To enter this mode you have to call EnableRotationalTradingO function at the very 
beginning of your formula. From then on using of buy/sell/short/cover variables is not 
allowed. Only PositionScore variable will be used to rank securities and trade top N 
securities.. 

A simple rotational trading formula (stocks with high RSI are best candidates for shorting 
while stocks with low RSI are best candidates for long positions): 

EnableRotationalTradingO ; 

SetOption ( "WorstRankHeld" , 5 ); 

PositionSize = -25; // invest 25% of equity in single security 
PositionScore = 50 - RSI(); // PositionScore has the same meaning as 
rScore in PT 

The score (PositionScore) for all securities is calculated first. Then all scores are sorted 
according to absolute value of PositionScore. Then top N are choosen to be traded. N 
depends on available funds and "max. open positions" setting. Backtester successively 
enters the trades starting from highest ranked security until the number of positions open 
reaches "max. open positions" or there are no more funds available. The score has the 
following meaning: 

• higher positive score means better candidate for entering long trade 


EnableRotationalTrading - Turns on rotational-trading mode of the backtester 
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EXAMPLE 

• lower negative score means better candidate for entering short trade 

• the score of zero means no trade (exit the trade if there is already open position on 
given symbol) 

• the score equal to scoreNoRotate constant means that already open trades should 
be kept and no new trades entered 

• the score equal to scoreExitAii constant causes rotational mode backtester to exit 
all positions regardless of HoldMinBars. Note that this is global flag and it is enough 
to set it for just any single symbol to exit all currently open positions, no matter on 
which symbol you use scoreExitAii (it may be even on symbol that is not currently 
held). By setting PositionScore to scoreExitAii you exit all positions immediatelly 
regardless of FloldMinBars setting 

Exits are generated automatically when security's rank drops below "worst rank held". 

There is no real control over when exits happen except of setting low score to force exits. 

You can also set the score on any (at least one) security to value of scoreNoRotate to 
prevent rotation (so already open positions are kept). But this is global and does not give you 
individual control. 

Important: 

The rotational trading mode uses "buy price" and "buy delay" from the Settings | 

Trade page as trade price and delay for both entries and exits (long and short) 

EnableRotationalTrading ( ); 

SetOption ( "WorstRankHeld" , 5 ); 

PositionSize = -25; // invest 25% of equity in single security 
PositionScore = 50 - RSI(); // PositionScore has the same meaning as 
rScore in PT 

SEE ALSO 

SetBacktestModeO function 

References: 



The EnableRotationalTrading function is used in the foliowing formulas in AFL on-line library: 
• Relative Strength 

More information: 

Updated on-line reference 


EnableRotationalTrading- Turns on rotational-trading mode of the backtester 
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EnableScript Miscellaneous functions 

- enable scripting engine 


SYNTAX EnableScript( "enginename") 

RETURNS NOTHING 

FUNCTION Enables AFL scripting host, enginename specifies which scripting ianguage wiii be used. 
Aiiowabie vaiues: "jscript", "vbscript". 

EXAMPLE EnabieScript( "jscript"); 

EnabieScript("vbscript"); SEE ALSO AFL scripting host 

SEE ALSO 
References: 


The EnableScript function is used in the foiiowing formuias in AFL on-iine iibrary: 

• accum/dist mov avg crossover SAR 

• AFL-Excei 

• AR_Prediction.afi 

• Buiiish Percent Index 2 files combined 

• danningham penetration 

• Heatmap V1 

• Hilbert Study 

• Kagi Chart 

• Monthly bar chart 

• Now Send Push Notifications From Amibroker 

• nth (1 - 8 ) Order Polynomial Fit 

• P&F chart with range box sizes 

• Polarized Fractal Efficiency 

• Prashanth 

• OP2 Float Analysis 

• Standard Error Bands 

• Steve Woods' Cum. Vol. Float + Cum. Vol. Channels 

• Steve Woods' Float Channel Lines 

• tomy_frenchy 

• Trend Continuation Factor 

• Triangle exploration using P&F Chart 

• Trigonometric Fit - TrigFit with AR for cos / sin 

More Information: 

Updated on-line reference 


EnableScript - enable scripting engine 
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EnableTextOutput 

- allows to enable or disable text output 


Miscellaneous functions 

(AFL 2.20) 


SYNTAX EnableTextOutput( mode) 


RETURNS NOTHING 


FUNCTION Enables or disables text output in commentary/interpretation/report charts. 


mode parameter has the following meaning: 

• 0 - disable output of string literals and assignment in interpretation/commentary 

• 1 - enable output of string literals and assignment in interpretation/commentary 

• 2 - reserved for future use 

• 3 - enable HTML text output in Report Charts (See Profit Table.afl for example code) 


EXAMPLE 

SEE ALSO 
References: 

The EnableTextOutput function is used in the following formulas in AFL on-line library: 

• Another Fib Level 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Button trading using AB auto trading interface 

• Elder Impulse Indicator V2 

• Heatmap VI 

• Manual Bracket Order Trader 

• Square of Nine Roadmap Charts 

• Woodie's CCI Panel Full Stats 

More Information: 

Updated on-line reference 


EnableTextOutput - allows to enable or disable text output 666 
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EncodeColor 

- encodes color for indicator title 


Exploration / Indicators 

(AFL 2.2) 


SYNTAX EncodeColor( co/of/ndex) 
RETURNS STRING 


FUNCTION Converts color index to string escape sequence that changes coior of text output in chart 

titie. Coior escape sequence uses cXX sequence where XX is 2 digit number specifying coior 
index c38 - defines vioiet, there is a speciai sequence c-1 that resets to defauit axis coior. 

EXAMPLE Titie = "This is written in " + EncodeColor( coiorVioiet) + "vioiet coior" + EncodeColor( 
coiorGreen ) + "and this in green"; SEE ALSO Using coiors in Indicator Buiider 

SEE ALSO 

References: 


The EncodeColor function is used in the foiiowing formuias in AFL on-iine iibrary: 

• 'R' Channei 

• ADX Indicator - Coiored 

• Andrews PitchforkV3.3 

• Another Fib Level 

• automatic trendlines using fractal patterns 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI Woodies Style 

• Color Display.afl 

• Coppock Trade Signal on Price Chart 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• EMA Crossover Price 

• FastStochK FullStochK-D 

• Fibonacci Internal and External Retracements 

• Fre 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Futures - Dollar Move Indicator 

• Futures - Dollar Move Today Indicator 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Hurst "Like" DE 

• IBD relative strength database Viewer 

• Improved NH-NH scan / indicator 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• JEEVAN'SSRI CHAKRA 

• Last Five Trades Result Dashboard - AFL code 

• mitalpradip 

• N Line Break Chart 

• P&F chart with range box sizes 

• Position Sizing and Risk Price Graph 


EncodeColor - encodes color for indicator title 
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• Position Sizing and Risk Price Graph - 2 

• Price with Woodies Pivots 

• Reiative Strength Muitichart of up to 10 tickers 

• Robert Antony 

• RSI of Weekly Price Array 

• RUTVOL timing signal with BB Scoring routine 

• Schiff Lines 

• Shares To Buy Price Graph 

• Square of Nine Roadmap Charts 

• Stochastic of Weekly Price Array 

• Super Trend Indicator 

• Support Resistance levels 

• TD Sequential 

• Trading ATR 10-1 

• Triangular Moving Average 

• Triangular Moving Average new 

• Vertical Horizontal Filter (VHF) 

• Volume Occilator 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

• ZigZag Hi Lo Barcount 

More information: 

Updated on-line reference 


EncodeColor- encodes color for indicator title 
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EndValue 

- value of the array at the end of the selected range 


Date/Time 

(AFL 2.3) 


SYNTAX EndValue( ARRAY) 

RETURNS NUMBER 

FUNCTION This function gives the singie vaiue (number) of the ARRAY at the end of the seiected range, 
if no range is marked then the vaiue at the iast bar is returned. 


To seiect the range you have to doubie ciick in the chart at the beginning of the range and 
then doubie ciick in the chart at the end of the range. Then > < markers wiii appear above 
date axis. 

EXAMPLE 1 . Simpie commentary: 


WriteVal( BeginValue( DateTimeO ), formatDateTime ); 
WriteVal( EndValue( DateTimeO ), formatDateTime ); 
"Precentage change of close is " + 

WriteVal( 100 * (EndValue( Close ) - BeginValue( Close 
))/BeginValue( Close ) ) + 

2. Get the number of bars in the range and caicuiate some stats for that range: 


Period = EndValue ( BarIndexO ) - BeginValue ( BarIndexO ); 
StandardDeviationInTheRange = EndValue( StDev( Close, Period 


SEE ALSO BEGiNVALUEO function 

References: 


); 


The EndValue function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Adaptive Price Channei 

• Another Fib Levei 

• CAMSLiM Cup and Fiandie Pattern AFL 

• Congestions detection 

• Futures - Doiiar Move indicator 

• nth (1 - 8 ) Order Poiynomiai Fit 

• Reiative Strength Muitichart of up to 10 tickers 

• Trend Lines from 2 points 

More Information: 


Updated on-iine reference 


EndValue - value of the array at the end of the selected range 
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Equity 

- calculate single-symbol equity line 


Trading system toolbox 

(AFL 2.0) 


SYNTAX equity( Flags = 0, RangeType = -1, From = 0, To = 0 ) 

RETURNS ARRAY 

FUNCTION NOTE: This function is ieft here for backward compatibiiity and is using oid, singie-security 
backtester. New coding shouid rather use portfoiio-ievei equity (speciai —EQUiTY ticker). 

Function: 

Returns singie-security Equity iine based on buy/seii/short/cover ruies, 
buy/seii/short/coverprice arrays, aii appiy stops, and aii other backtester settings. Flags - 
defines the behaviour of Equity function 

0 : (defauit) Equity works as in 3.98 - just caicuiates the equity array 

1 : works as 0 but additionaiiy updates buy/seii/short/cover arrays so aii 
redundant signais are removed exactiy as it is done internaiiy by the 
backtester pius aii exits by stops are appiied so it is now possibie to visuaiise 
AppiyStopO stops. 

2 : (advanced) works as 1 but updated signais are not moved back to their 
originai positions if buy/seii/short/cover deiays set in preferences are 
non-zero. Note: this vaiue of fiag is documented but in 99% of cases shouid 
not be used in your formuia. Other vaiues are reserved for the future. 

RangeType - defines quotations range being used: 

-1 : (defauit) use range set in the Automatic anaiysis window 
0 : aii quotes 

1 : n iast quotes (n defined by 'From' parameter) 

2 : n iast days (n defined by 'From' parameter) 

3 : From/To dates 


From : defines start date (datenum) (when RangeType == 3) or "n" parameter (when 
RangeType == 1 or 2) 

To: defines end date (datenum) (when RangeType == 3) otherwise ignored 

datenum defines date the same way as DateNum() function as YYYMMDD 
where YYY is (year - 1900), MM is month, DD is day 

December 31 st, 1999 has a datenum of 991231 

May 21st, 2001 has a datenum of 1010521 Aii these parameters are evaiuated at the time of 
the caii of Equity function. Compiete equity array is generated at once. Changes to 
buy/seii/short/cover ruies made after the caii have no effect. Equity function can be caiied 
muitipie times in singie formuia. 

iMPORTANT NOTE: Equity() function uses so caiied "oid" singie-security backtester that 
offers oniy subset of features of new backtester. To retrieve vaiue of portfoiio-ievei equity 
generated by new backtester use Foreign("—EQUiTY", "C"). 

EXAMPLE Buy = //your Buy rule; 


Equity - calculate single-symbol equity line 
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Sell = //your Sell rule; 
GraphO = Equity (); 

SEE ALSO 
Comments: 


Herman van den 
Bergen 

psytek@magma.ca 

2003-02-23 

09:46:19 

When the Equity function is cailed muitipie times in a singie formuia one must be 
carefull when using it with AppiyStop(). 

Tomasz wrote: "Equity(l) changes buy/sell variables (evaluates stops - and writes 
them back to buy/sell arrays). If you are using non-zero delays both Equity calls will 
return different values because in first case exits are generated by stops (not delayed) 
and in second case STOP signals written back to buy/sell arrays are delayed 
(opposite to the first case). 

Equity(l) affects the buy/sell variables. It is not a "no-operation" function. If you want a 
"no-op" you should use Equity( 0 ) to generate equity line. 

This is by design and described in the User's Guide. AFL reference: Equity function 
and chart 

Tomasz Janeczko 

tj -at- 

amibroker.com 

2003-05-21 

17:56:46 

Using Equity( 1 ) evaluates stops and writes BACK 
signals to sell/cover arrays. Equity(l) also removes 
all extra signals. 

Depending on kind of the stop various values 
are written back to sell/cover array to enable you 
to distinguish if given signal was generated by regular 
rule or by stop. 

1 - regular exit 

2 - max. loss 

3 - profit target 

4 - trailing 

5 - n-bar stop 

6 - ruin stop 

... your rules... 

ApplyStop( stopTypeTrail, stopModePercent, 10, True ); 

Equity( 1 ); 

Writelf( sell == 1, "Regular exit", 

Writelf( sell == 4, "Trailing stop","")); 

Tomasz Janeczko 

tj -at- 

amibroker.com 

2003-05-29 

05:27:07 

When your formula uses Equity(l) you should avoid using built-in delays. Here is a 
story why: 

Only BACKTESTER implements delays while EXPOLORATION and other modes do 
NOT. 

Therefore Equity(l) must not delay signals by itself. However in order to perform 
equity calculations delays must be applied to match backtester output, so 

AmiBroker when it encounters Equity(l) applies the delays (even in exploration. 


Equity- calculate single-symbol equity line 
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indicator, etc) 

but just before end of the equity cali AmiBroker must ADJUST BACK the signals, so 
Equity-adjusted buy/sell/short/cover arrays do NOT have delay applied. 

This involves shifting updated bars back and this may cause problem if signal occurs 
on the very last bar (because it is moved by delay outside the range). 

To disable this shifting back in exploration (so exploration matches the output of 
backtester 

with NON-ZERO delays) you need to use Equity( 2 ) 

On the other hand using Equity(2) in backtest formula causes double delay. 

(one added by the equity function, second added by the backtester pass). 

Built-in delays are designed to be used in BACKTESTER ONLY. 

The intention is as follows: set non zero delays in the settings 

now SINGLE formula can be used to BACKTEST and to get TODAY SIGNALS 

for trading for tommorrow (in SCAN) mode. 

Solution 1: 

Embbed delays in the AFL code itself: 

Buy = Ref( Buy, -1 ); 

Sell = Ref( Sell, -1 ); 

Solution 2: 

When using Equity AND EXPLORATION 
Use EOUITY( 2 ) but except of backtest mode 
if( Status("action") != 5 ) e = Equity( 2 ); 


Tomasz Janeczko 

IMPORTANT NOTE: 

tj -at- 

amibroker.com 

EquityO function is using OLD backtester that is missing some recently added features 

2006-08-13 

such as multiple-currency handling and scaling in/out. 

08:30:15 

New code should rather use new, portfolio-level backtester, i.e. —EOUITY special 
ticker. 


Refer to: 

http://www.amibroker.com/guide/a_equity.html 


for details about differences between new and old backtesters. 


References: 


The Equity function is used in the following formulas in AFL on-line library: 

• 'R' Channel 

• AFL-Excel 

• Auto-Optimization Framework 

• Chandelier Exit or Advanced Trailing Stop 

• CoinToss ver 1 

• Ed Seykota's TSP: EMA Crossover System 

• Kelly criterion 

• Last Five Trades Result Dashboard - AFL code 


Equity- calculate single-symbol equity line 
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• Plot the Equity Curve without Backtesting? 

• Scale Out: Futures 

• SectorRSI 

• Visualization of stoploses and profit in chart 

More information: 

Updated on-line reference 


Equity- calculate single-symbol equity line 
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Error 

- displays user-defined error message and stops the execution 


Miscellaneous functions 

(AFL 3.7) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 


ErrorC'text") 

NOTHING 

The function stops the formula execution in the place of the call and displays user-specified 
error message. It may be also uses from plugins to display error messages. 

if ( LowestVisibleValue ( Close ) < 0 ) ) 

{ 

Error ( "Close price is negative"); 

} 


SEE ALSO 
References: 


The Error function is used in the following formulas in AFL on-line library: 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Button trading using AB auto trading interface 

• Manual Bracket Order Trader 

• Tracking Error 

• Tracking Error 

More Information: 


Updated on-line reference 


Error - displays user-defined error message and stops the execution 
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EXP 

- exponential function 


SYNTAX exp( NUMBER) 
exp( ARRAY) 

RETURNS NUMBER, 
ARRAY 


FUNCTION Calculates e raised to the NUMBER or ARRAY power. 

EXAMPLE 

SEE ALSO The log() function 

References: 


The EXP function Is used In the following formulas In AFL on-line library: 

• Andrews Pitchfork 

• Andrews PltchforkV3.3 

• Arnaud Legoux Moving Average (ALMA) 

• AR_Predlctlon.afl 

• Auto-Optimizatlon Framework 

• Black Scholes Option Pricing 

• Demand Index 

• Demand Index 

• Ehlers Fisher Transform 

• Log Time Scale 

• Multicycle 1.0 

• Multiple Ribbon Demo 

• Neural Network Powered Smooth/PredIctIve RSI V2 

• Option Calls, Puts and days till third friday. 

• Probability Calculator 

• Probability Density & Gaussian Distribution 

• Schiff Lines 

• Smoothed Adaptive Momentum 

• Stress with SuperSmoother 

• Three Pole Butterworth 

• Trigonometric Fit - TrIgFIt with AR for cos / sin 

• Volume Occllator 


More information: 

Updated on-line reference 


EXP - exponential function 
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ExRem 

- remove excessive signals 


Trading system toolbox 

(AFL 1.5) 


SYNTAX exrem( ARRAY1, ARRAY2 ) 


RETURNS ARRAY 


FUNCTION removes excessive signals: 


returns 1 on the first occurence of "true" signal in Arrayl 

then returns 0 until Array2 is true even if there are "true" signals in Arrayl 


EXAMPLE buy = ExRem( buy, sell); 

sell = ExRem( sell, buy ); 


SEE ALSO 
References: 

The ExRem function is used in the following formulas in AFL on-line library: 

• 4% Model - Determine Stock Market Direction 

• Advanced MA system 

• ADXbuy 

• AFL Example 

• AFL Example - Enhanced 

• An n bar Reversal Indicator 

• Andrews PitchforkV3.3 

• ATR Study 

• Auto-Optimization Framework 

• Automatic Trendlines using multiple timeframes 

• Awsome Oscilator 

• Bollinger band normalization 

• Bull Fear / Bear Fear 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• Chandelier Exit or Advanced Trailing Stop 

• Channel/S&R and trendlines 

• Connors TPS 

• Demand Index 

• DMI Spread Index 

• Ema bands 

• Envelope System 

• FastStochK FullStochK-D 

• Fib Fan Based on ZZ 

• Gann HiLo Indicator and System 

• Hilbert Study 

• Hull Moving Average 

• ICHIMOKU SIGNAL TRADER 

• JEEVAN'S SRI CHAKRA 

• OBV with Linear Regression 

• Perceptron 

• Peterson 

• Pivot End Of Day Trading System 


ExRem - remove excessive signals 
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• Plot the Equity Curve without Backtesting? 

• Pullback System No. 1 

• Rebalancing Backtest avoiding leverage 

• Relative Momentum Index (RMI) 

• Reverse MFI Crossover 

• RSI Double-Bottom 

• RSIS 

• RUTVOL timing signal with BB Scoring routine 

• Schiff Lines 

• SectorRSI 

• STD_STK Multi 

• Stochastic Fast%K and Full 

• StochD_StochK Single.afl 

• Stress with SuperSmoother 

• Super Trend Indicator 

• TD sequential 

• TD Sequential 

• The D_oscillator 

• The Three Day Reversal 

• Trading ATR 10-1 

• Trend Continuation Factor 

• Triangular Moving Average new 

• TTM Squeeze 

• Using From and To dates from Auto Analysis in Code 

• Visualization of stoploses and profit in chart 

• Vivek Jain 

• Williams Alligator system 

• Woodie's CCI Panel Full Stats 

• Zig Zag Indicator with Valid Entry and Exit Points 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


ExRem- remove excessive signals 
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ExRemSpan 

- remove excessive signals spanning given number of bars 


Trading system toolbox 

(AFL 2.0) 


SYNTAX exremspan( ARRAY1, numbars ) 

RETURNS ARRAY 

FUNCTION Removes excessive signals that span numbars bars since initial signal. 

(In other words first non-zero bar passes through, then all subsequent non-zero bars are 
ignored (zero is returned) until numbars bars have passed since initial signal. From then on a 
new signal may pass through) 

This function is marked as obsolete. 


To implement N-bar stop you should use ApplyStop function instead. 


EXAMPLE 

SEE ALSO ApplyStopQ function 

References: 


The ExRemSpan function is used in the following formulas in AFL on-line library: 

• ekeko price chart 

• SectorRSI 


More information: 


Updated on-line reference 


ExRemSpan - remove excessive signals spanning given number of bars 
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fclose 
- close a file 


File Input/Output functions 

(AFL 2.5) 


SYNTAX fclose( filehandle) 


RETURNS NOTHING 


FUNCTION Closes a file. 


The filehandle (NUMBER) should be the handle returned by fopen function. 


EXAMPLE fh = fopen ( "myfile.txt", "w"); 
if( fh ) 


fputs ( "Testing", fh ); 
fclose ( fh ); 


SEE ALSO fopen() function , fputs() function , fgetsQ function 

References: 

The fclose function is used in the following formulas in AFL on-line library: 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• AutoTrade using an Exploration 

• Continuous Contract Rollover 

• Export All Daily Data to TXT with MS import format 

• Export EOD or Intraday to .csv file 

• Export Intraday Data 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Herman 

• IBD relative strength database ranker 

• IBD relative strength database Viewer 

• TWS auto-export Executions-file parser 

• TWS trade plotter 

• WLBuildProcess 

More Information: 

Updated on-line reference 


fclose - close a file 
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fdelete Input/Output functions 

- deletes a file 


SYNTAX 

fdelete( "filename") 

RETURNS 

NUMBER 

FUNCTION 

This function deletes a file. 

"filename" is path to the file name (relative or full path). If just file name without path is 
specified then AmiBroker directory is used, returns TRUE if file successfully deleted, FALSE 
otherwise 


EXAMPLE 


SEE ALSO 

fopen() function , fclose() function 

References: 



The fdelete function is used in the foiiowing formuias in AFL on-iine iibrary: 
• TWS auto-export Executions-fiie parser 

More information: 

Updated on-line reference 


fdelete - deletes a file 
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fdir 

- list directory content 


File Input/Output functions 

(AFL 3.70) 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


SEE ALSO 
References: 


fdir( "wildcard", flags = 1) 

STRING 

The function returns comma separated directory iist (iike "DIR" command) 

"wildcard" is a path with a wildcard pattern to match. 

For example will give you all files in C: drive, but "C:\*.txt" will give you only files with 

.txt extension. 

flags - controls what is returned the default is 1 - only files, 2 - only directories, 3 - both files 
and directories 

printf ( "Only files: " ); 

_N( list = fdir( 1 ) ); 

for (1=0; ( filename = StrExtract ( List, i ) ) != "" ; i++ ) 

{ 

printf ( filename + " " ); 


printf ( " Only directories: " ); 

_N( list = fdir( 2 ) ) ; 

for ( i = 0 ; ( filename = StrExtract ( List, i ) ) != "" ; i++ ) 

{ 

printf ( filename + " " ); 


printf ( " Both files and directories: " ); 

_N( list = fdir( "c:\*.*", 3 ) ) ; 

for ( i = 0 ; ( filename = StrExtract ( List, i ) ) != "" ; i++ ) 

{ 

printf ( filename + " " ); 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


SEE ALSO 
References: 


The fdIr function is used in the following formulas in AFL on-line library: 


More Information: 


Updated on-line reference 


fdir - list directory content 
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fdir - list directory content 
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feof File Input/Output functions 

- test for end-of-file ^ 


SYNTAX feof( filehandle) 

RETURNS NUMBER 

FUNCTION The feof function returns a nonzero value after the first read operation that attempts to read 
past the end of the file. It returns 0 if the current position is not end of file. There is no error 
return value. 


filehandle is a file handle returned by fopen function. 

EXAMPLE // 

// The following code (commentary) reads 
// all lines from the external file and 
// displays it in commentary window 

fh = fopen ( "quotes. CSV" , "r"); 

if( fh ) 

{ 

while ( ! feof ( fh ) ) 

{ 

printf ( fgets ( fh ) ); 

} 

} 

else 

{ 

printf ( "ERROR: file can not be found (does not exist)"); 

} 


SEE ALSO fopen() function , fclose() function , fgets() function 

References: 

The feof function is used in the following formulas in AFL on-line library: 

• AFL_Glossary_Converter 

• Calculate composites for tickers in list files 

• Herman 

• IBD relative strength database Viewer 

• MFE and MAE and plot trades as indicator 

• TWS auto-export Executions-file parser 

• TWS trade plotter 

• WLBuildProcess 

More information: 

Updated on-line reference 


feof - test for end-of-file 
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FFT 

- performs Fast Fourier Transform 


Basic price pattern detection 

(AFL 2.90) 


SYNTAX FFT( array, ien = 0 ) 

RETURNS ARRAY 

FUNCTiON The function performs FFT (Fast Fourier Transform) on iast 'ien' bars of the array, if ien is set 
to zero, then FFT is performed on entire array, ien parameter must be even. 

Resuit: 


function returns array which holds FFT bins for first 'Ien' bars. There are len/2 FFT complex 
bins returned, where bin is a pair of numbers (complex number): first is real part of the 
complex number and second number is the imaginary part of the complex number. 

result = FFT( array, 256 ); 

where: 


• 0th bin (result[0] and result[1]) represents DC component, 

• 1st bin (result[1 ] and result[2]) represents real and imaginary parts of lowest 
frequency range and so on upto result[ Ien - 2 ] and result[ Ien - 1 ] 


remaining elements of the array are set to zero. 

IMPORTANT note: input array for FFT must NOT contain any Null values. Use Nz() function 
to convert Nulls to zeros if you are not sure that input array is free from nulls. 


FFT bins are complex numbers and do not represent real amplitude and phase. To obtain 
amplitude and phase from bins you need to convert inside the formula. The following code 
snipplet does that: 


ffc = FFT (data,Len); 

for ( i = 0; i < Len - 1; i = i + 2 ) 
{ 


amp[ i ] 
phase [ i 


amp[ i + 1 ] = 
= phase [ i + 1 


sqrt (ffc [ i ] -^ 2 + 

] = atan2 ( ffc[ i + 


ffc[ i + 1 
1], ffc[ i ] 


' 2 ) ; 


) ; 


EXAMPLE 


SetBarsRequired (100000, 100000) ; 

Len = ParamC'FFT Length", 1024, 64, 10000, 10 ); 


Len = Min ( Len, BarCount ); 


X = Barindex (); 

xl = X - BarCount + Len; 


Input = C; 


FFT - performs Fast Fourier Transform 
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SEE ALSO 


a = LastValue ( LinRegIntercept ( input, Len - 1 ) ); 
b = LastValue ( LinRegSlope ( input, Len - 1 ) ); 


Lr = a + b * xl; 

data = input - Lr;// de-trending 
ffc = FFT (data,Len); 

for ( i = 0; i < Len - 1; i = i + 2 ) 

{ 

amp [ i ] = amp [ i + 1 ] = sqrt(ffc[ i ] 2 + ffc[ i + 1 ]'' 2 ); 
phase[ i ] = phase[ i + 1 ] = atan2 ( ffc[ i + 1], ffc[ i ] ); 

} 


auto = ParamToggle ( "Auto dominant cycle", "No| Yes", 1 ); 
sbar = Param( "Which FFT bin", 1, 0, 50 ) ; 

skipbinl = ParamToggle ( "Skip 1st FFT bin", "No| Yes", 1 ); 

if ( auto ) 

{ 

sbar = int ( LastValue(ValueWhen ( amp == LastValue (Highest ( Ilf ( 
skipbinl AND x < 4, 0 , amp ) )) , x / 2 )) ) ; 

} 


fv = Status ( "firstvisiblebar" ); 

thisbar = Ref ( int(x/2) == sbar, -fv); 

Plot ( Ref (amp,-fv), 

"amplitude (bin " + Ref ( int(x/2), -fv ) +")", IIf( thisbar, 

colorRed, colorBlack ),styleArea); 

Plot ( Ilf ( BarCount - BarIndexO < Len, data. Null ) , 

"de-trended input ("+Len+" bars)", colorOrange, styleLeftAxisScale 

); 

Plot ( cos ( phase[ sbar * 2 ] + (sbar) * xl * 2 * 3.1415926 / Len ), 
" dominant cycle "+ Len/ (sbar) + "(" + sbar + " bin) bars", 

colorBlue, styleOwnScale ) ; 

GraphZOrder=l; 

GraphXSpace = 10; 


atan2() function 


FFT - performs Fast Fourier Transform 
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References: 

The FFT function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-line reference 


FFT- performs Fast Fourier Transform 
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fgets 

- get a string from a file 


File Input/Output functions 

(AFL 2.5) 


SYNTAX fgets( filehandle ) 

RETURNS STRING 

FUNCTION The fgets function reads a string from the input fiie (defined by filehandle argument) and 
returns it as a resuit. 


fgets reads characters from the current fiie position to and inciuding the first newiine 
character, or to the end of the fiie whichever comes first. The newiine character, if read, is 
included in the returned string. 

The filehandle argument is a number returned by fopen function. The file has to be opened 
with "r" flag (for reading). 

NOTE: fgetsO reads maximum 1024 characters per line. Lines longer than that can be read 
using sequential calls to fgets() and "adding" (concatenating) results. 

EXAMPLE // 

// The following code (commentary) reads 
// all lines from the external file and 
// displays it in commentary window 

fh = fopen ( "quotes. CSV" , "r"); 

if( fh ) 

{ 

while ( ! feof ( fh ) ) 

{ 

printf ( fgets ( fh ) ); 

} 

} 

else 


} 


printf ( "ERROR: file can not be found (does not exist)"); 


SEE ALSO fopen() function , fclose() function 

References: 

The fgets function is used in the following formulas in AFL on-line library: 

• AFL_Glossary_Converter 

• Calculate composites for tickers in list files 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Herman 

• IBD relative strength database Viewer 

• MFE and MAE and plot trades as indicator 

• TWS auto-export Executions-file parser 


fgets - get a string from a file 
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• TWS trade plotter 

• WLBuildProcess 

More information: 

Updated on-line reference 


fgets- get a string from a file 
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fgetstatus 

- retrieves file status/properties 


File Input/Output functions 

(AFL 2.90) 


SYNTAX fgetstatus( filename, what, format = 0 ) 

RETURNS NUMBER or STRING 

FUNCTION The function that retrieves fiie properties/status. 

Returns NUMBER or STRING depending on format parameter. If file does not exist it returns 
Null. 

Parameters: 

• filename - the name of the file (with or without full path) to query 

• what - specifies what file property to retrieve, allowable values 

0 - the date/time the file was created 

♦ 1 - the date/time the file was last modified 

♦ 2 - the date/time the file was last accessed for reading 

♦ 3 - the file size in bytes 

♦ 4 - attribute byte of the file 

• format - specifies return format of date/time values (format specifications are the 
same as in Now() function): allowed values: 

♦ 0 - returns string containing date/time formatted according to system settings 

♦ 1 - returns string containing date only formatted according to system settings 

♦ 2 - returns string containing time only formatted according to system settings 

♦ 3 - returns DATENUM number with date 

♦ 4 - returns TIMENUM number with time 

♦ 5 - returns DATETIME number with date/time 

♦ 6 - returns date DAY (1..31) 

♦ 7 - returns date MONTH (1..12) 

♦ 8 - returns date YEAR (four digit) 

♦ 9 - returns date DAY OF WEEK (1..7, where 1=Sunday, 2=Monday, and so 
on) 

♦ 10 - returns date DAY OF YEAR (1 ..366) 

Note that Windows supports only 2 second resolution of file date/time stamps. 

EXAMPLE // get modification date string of portfolio.af1 file 
fgetstatus ( "formulas!\Equity\\portfolio.afl", 1,0); 

SEE ALSO fcloseO function , fdelete() function , feof() function , fgets() function , fmkdir() function , 
fopenQ function , fputs() function , frmdir() function 

References: 

The fgetstatus function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


fgetstatus - retrieves file status/properties 
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FIR 

- Finite Impuise Response fiiter 


Moving averages, summation 

(AFL 3.40) 


SYNTAX FiR( array, coefficients, size ) 

RETURNS ARRAY 

FUNCTiON This function impiements generai-purpose Finite impuise Response fiiter (FiR) 
http://en.wikipedia.org/wiki/Finite_impuise_response 

The output is convoiution of input aray with coefficents tabie (impuise response tabie). 

The function performs automatic normaiization of coefficient tabie if necessary (if its sum is 
not 1) 

iNPUTS: 

• array - input array to be smoothed 

• coefficients - array of FiR coefficients 

• size - number of coefficients (fiiter_order + 1 ) 

it is functionai (but 2+ times faster) equivaient of foiiowing AFL: 

function FIR_AFL( input, coeff, size ) 

{ 

result = 0; 
sumcoeff = 0; 

for ( i = 0; i < Min ( size, BarCount ); i++ ) 

{ 

sumcoeff += coeff[ i ]; 

result += coeff[ i ] * Ref ( input, - size + i + 1 ); 

} 


return result/sumcoeff; 

} 


EXAMPLE // for example 5 bar weighted moving average can be written: 
coeff[ 0 ] = 1; 

coeff[ 1 ] = 2; 

coeff[ 2 ] = 3; 

coeff[ 3 ] = 4; 

coeff[ 4 ] = 5; 

FIR( Close, coeff, 5 ); 

// Another example: ALMA which is FIR Filter with 

// shifted Gaussian coefficents can be implemented as follows: 

function ALMA_AFL( input, range. Offset, sigma ) 

{ 

local m, im, s, Coeff; 


FIR - Finite Impulse Response filter 
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m = floor ( Offset * (range - 1) ); 

s = range / sigma; 

for ( 1=0; i < Min ( range, BarCount ); i++ ) 

{ 

im = i - m; 

Coeff[ 1 ] = exp (- (im*im)/ (2*s*s) ); 

} 

return FIR( input, Coeff, range ); 

} 

SEE ALSO 
References: 

The FIR function is used in the foliowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 


FIR- Finite Impulse Response filter 
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FirstVisibleValue 
- get first visible value of array 


Indicators 

(AFL 3.40) 


SYNTAX FirstVisibleValue( array) 

RETURNS NUMBER 

FUNCTION When used in charts / indicators /interpretation the function returns the vaiues of array at first 
visibie bar. 


In other (non-indicator) modes the function returns array eiements with subscripts of 0. 

Note that these functions do not affect QuickAFL, so LastVisibieValue may be used instead 
of LastVaiue. These functions are intended to complement functionality already available via 
HighestVisibleValue and LowestVisibleValue. 

EXAMPLE X = C; 

Plot ( X, "x", colorRed ); 

Plot ( FirstVisibleValue ( x ), "fvv", colorGreen ); 

Plot ( LastVisibieValue ( x ), "Ivv", colorBlue ); 

SEE ALSO HighestVisibleValueO function , LowestVisibleValue() function , LastVisibleValue() function 

References: 


The FirstVisibleValue function is used in the following formulas in AFL on-line library: 
• Congestions detection 

More Information: 


Updated on-line reference 


FirstVisibleValue - get first visible value of array 
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Flip 


Trading system toolbox 

(AFL 1.5) 


SYNTAX flip( ARRAY1, ARRAY2 ) 

RETURNS ARRAY 


FUNCTION works as a flip/flop device or "latch" (electronic/electric engineers will know what I mean) 
returns 1 from the first occurence of "true" signal in Arrayl 
until a "true" occurs in Array2 which resets the state back to zero 
unil next "true" is detected in Arrayl... 

EXAMPLE buy = ExRem( buy, sell); 

buy = Flip( buy, sell); // this essentially reverts the process of ExRem - multiple signals are 
back again 

SEE ALSO 
References: 


The Flip function is used in the following formulas in AFL on-line library: 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• Candle Stick Demo 

• Channel/S&R and trendlines 

• Connors TPS 

• Fre 

• Heatmap VI 

• Multiple Ribbon Demo 

• RUTVOL timing signal with BB Scoring routine 

• Stops Implementation in AFS 

• TD Sequential 

More information: 


Updated on-line reference 


Flip- 
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floor 

- floor value 


SYNTAX floor( NUMBER) 
floor( ARRAY) 

RETURNS NUMBER, 
ARRAY 


FUNCTION Calculates the highest Integer that Is less than NUMBER or ARRAY. 

EXAMPLE The function floor ( 18.9 ) returns 18. 

The formula floor ( -19.9 ) returns-20. 

SEE ALSO CEIL() function 

References: 


The floor function Is used In the following formulas In AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Arnaud Legoux Moving Average (ALMA) 

• AR_Predlctlon.afl 

• Bullish Percent Index 2 files combined 

• Bullish Percent Index 2004 

• Color Display.afl 

• Gann level plotter 

• Gann Swing Charts In 3 modes with text 

• Graphical sector analysis 

• Improved NH-NH scan / Indicator 

• JEEVAN'S SRI CHAKRA 

• Luna Phase 

• Murrey Math Price Lines 

• Option Calls, Puts and days till third friday. 

• P&F Chart - High/Low prices Sept2003 

• P&F chart with range box sizes 

• PF Chart - Close - April 2004 

• Point & figure Chart India Securities 

• Renko Chart 

• tomy_frenchy 

• Triangle exploration using P&F Chart 

• Trigonometric Fit - TrIgFIt with AR for cos / sin 

• VIsl-Trade 

• Volume Charts 

More information: 


Updated on-line reference 


floor - floor value 
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fmkdir 

- creates (makes) a directory 


File Input/Output functions 

(AFL 2.70) 


SYNTAX fmkdir( "dirname") 


RETURNS NUMBER 


FUNCTION Creates (makes) a directory. 


"dirname" specifies path of the directory to be created. Piease note that this function creates 
oniy ONE directory at a time. So if you want to create nested directory tree you have to caii it 
muitipie times, for exampie to create C:MyDirectoryMySubDirectory foider you have to caii it 
twice: 

fmkdir ( "C : WMyDirectory " ); 

fmkdir( "C:\\MyDirectory\\MySubDirectory" ); 

Note aiso that it is safe to caii it even if directory aiready exists (then no change to file system 
is applied) 

Returns TRUE if directory successfully created, FALSE otherwise 


EXAMPLE 

SEE ALSO 
References: 

The fmkdir function is used in the following formulas in AFL on-line library: 

• Export EOD or Intraday to .csv file 

• IBD relative strength database ranker 

More information: 

Updated on-line reference 


fmkdir - creates (makes) a directory 
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fopen 

- open a file 


File Input/Output functions 

(AFL 2.5) 


SYNTAX fopen( "filename", "mode", shared = False ) 

RETURNS FILE handle 

FUNCTION Opens file, returns filehandle (NUMBER). 

File handle is non-zero if file opened successfully, zero on failure. 
Parameters: 


• filename - STRING - contains the path to the file name. Please note that single 
backslash in path must be written in AFL as (double backslash) 

• mode - STRING - access mode can be "r" - for reading, "w" for writing, "a" for 
appending (and all other regular C-runtime library modes) 

• shared (new in 5.80) - BOOLEAN - False - open file without checking for sharing. 
True - open file in share-aware mode. 

When sharing parameter is True the following things happen: 

• when mode is "w" (writing) or "a" (appending) then file is open with a sharing flag that 
denies others to read and/or write at the same time 

• when mode is "r" (reading) then file is open with a sharing flag that denies others to 
write to the file (shared reads are allowed) 

• when open is unsuccessful due to sharing violation (other processes / threads have 
that file open and deny reads/writes) then fopen would wait for 250ms and retry 
automatically 4 times. After 4 unsuccessful retries it fails with file handle == Null. 

When sharing parameter is set to False (default) no such checking occurs and file is open 
anyway without denying others to read/write. This may cause data corruption if file is written 
to from multiple threads/external processes at the same time. If you want to use this mode 
(sharing set to False) in multithreaded environment to write data, you need to care about 
synchronization yourself for example using critical section. 

EXAMPLE fh = fopen ( "myfile.txt", "w"); 
if( fh ) 

{ 

fputs ( "Testing", fh ); 

} 

else 


printf ( "Error opening file"); 

} 

SEE ALSO fcloseO function , fputs() function , fgets() function 

References: 


The fopen function is used in the following formulas in AFL on-line library: 
• AFL_Glossary_Converter 


fopen - open a file 
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• Auto Trade Step by Step 

• AutoTrade using an Exploration 

• Calculate composites for tickers in list files 

• Continuous Contract Rollover 

• Export All Daily Data to TXT with MS import format 

• Export EOD or Intraday to .csv file 

• Export Intraday Data 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Herman 

• IBD relative strength database ranker 

• IBD relative strength database Viewer 

• MFE and MAE and plot trades as indicator 

• TWS auto-export Executions-file parser 

• TWS trade plotter 

• WLBuildProcess 

More information: 

Updated on-line reference 


fopen- open a file 
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Foreign 

- access foreign security data 


Referencing other symbol data 

(AFL 1.5) 


SYNTAX foreign( TICKER, DATAFIELD, fixup = 1) 

RETURNS ARRAY 

FUNCTION Allows referencing other (than current) tickers In the AFL formulas. TICKER Is a string that 
holds the symbol of the stock. DATAFIELD defines which array Is referenced. Allowable data 
fields: "O" (open), "H" (high), "L" (low), "C" (close), "V" (volume), "I" (open Interest), and for 
V5.29 and above: "1" (auxi), "2" (aux2) 

The last parameter - fixup - accepts following values 

• 0 - the holes are not fixed 

• 1 - default value - missing data bar OHLC fields are all filled using previous bar 
Close and volume Is set to zero. 


Note: you can use ForeIgn/RelStrength without specifying last parameter: 

Forelgn( "ticker", "field"), RelStrength( "ticker") - then the holes will be fixed. 

• 2 - (old pre-4.90 behaviour) - causes filling the holes In the data with previous O, H, 
L, C, V values 

Unless you know what you are doing you should use DEFAULT value of fixup parameter 
(Flxup=1). If you do not use flxup=1, data holes will have the value of Null that you would 
need to handle by yourself. 

EXAMPLE // EXAMPLE 1: 

// Plotting spread between currently selected symbol and another one 
GraphO = Close - Foreign ( "MSFT", "Close" ) ; 


// EXAMPLE 2: 

// Built-in relative performance chart 

_N( TickerList = ParamStr ( "Tickers" , "JI,MSFT,GE" ) ); 

NumBars = 20; 

fvb = Status ( "firstvisiblebar" ); 

Plot ( 100 * ( C - C[ fvb ] ) / C[ fvb ], NameO, colorBlue ); 
for ( 1=0; ( symbol = StrExtract ( TickerList, 1 ) ) != ""; i++ ) 
{ 

fc = Foreign ( symbol, "C" ); 

if( ! IsNulK fc[ 0 ] ) ) 

{ 

Plot ( 100 * ( fc - fc[ fvb ] )/ fc[ fvb ], 
symbol, 

colorLightOrange + ( (2*1) % 15 ), 
styleLine ); 


PlotGrid( 0, colorYellow ); 


Foreign - access foreign security data 
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_N ( Title = "{{NAME}} - Relative Performance [%]: {{VALUES}}" ); 

SEE ALSO PLOTFOREIGNO function , SetForeign() function 

Comments: 


Tomasz 

Foreign function synchronizes the data file 

Janeczko 

you are referencing with the currently selected symbol. 

tj -at- 

amibroker.com 

Synchronization makes sure that EACH bar of FOREIGN data 

2003-08-07 

matches exactly with each bar of currently selected symbol. 

20:28:41 

So if DateNumO function returns 990503 for given bar 

then Close array represents the CLOSE of currently selected symbol at May 3, 1999 
and Foreign("SYMBOL", "C") represents close of foreign symbol at May 3, 1999 TOO. 


This is absolutely necessary because otherwise you won't be able 

to do ANY meaningful operations involving both selected symbol and foreign symbol. 


This also needed for the display so when you mark the quote with vertical 
line it will always match the date displayed regardless if you use Foreign or not. 


Please note that if you have data holes in currently selected symbol then in order to 
synchronize bars Foreign function will remove bars that exist in Foreign symbol but do 
not exist in currently selected symbol. 


References: 


The Foreign function is used in the foliowing formulas in AFL on-line library: 

• 30 Week Fli Indicator - Display 

• 4% Model - Determine Stock Market Direction 

• 52 Week New High-New Low Index 

• AccuT rack 

• Alpha and Beta and R_Squared Indicator 

• Auto-Optimization Framework 

• Bad Tick Trim on 5 sec database 

• Baseline Relative Performance Watchlist charts V2 

• Basket Trading System T101 

• BEANS-Summary of Holdings 

• BMTRIX Intermediate Term Market Trend Indicator 

• Bullish Percent Index 2004 

• Continuous Contract Rollover 

• COT REPORT 

• Dave Landry PullBack Scan 

• Detailed Equity Curve 

• Elder Triple Screen Trading System 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Heatmap V1 

• IB Backfiller 

• IBD relative strength database ranker 

• Improved NH-NH scan / indicator 


Foreign- access foreign security data 
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• Index of 30 Wk Highs Vs Lows 

• Indicator Expiorer (ZigZag) 

• Inter-market Yield Linear Regression Divergence 

• Intraday Fibonacii Trend Break System 

• Market Breadth Chart-In-Chart 

• MOCS 

• NASDAQ 100 Volume 

• qp2 industry charts as a panel in the stocks chart 

• Ranking and sorting stocks 

• Ranking Ticker WatchList 

• Relative Strength Multichart of up to 10 tickers 

• Rene Rijnaars 

• RUTVOL timing signal with BB Scoring routine 

• Sector Tracking 

• SectorRSI 

• Stress with SuperSmoother 

• The D_oscillator 

• Tracking Error 

• Tracking Error 

• Weighted Index 

• WLBuildProcess 

More information: 

Updated on-line reference 


Foreign- access foreign security data 
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fputs 

- write a string to a fiie 


File Input/Output functions 

(AFL 2.5) 


SYNTAX fputs( string, filehandle) 

RETURNS NOTHING 

FUNCTION Writes (puts) the string to the file. 

The filehandle must be a number returned by fopen function used to open the file. The file 
has to be open for writing or appending ("w" or "a") for this fputs to work. 

EXAMPLE // 

// The following code exports quotes 
// of current stock to quotes.csv 
// comma separated file 
// 

fh = fopen ( "quotes.CSV" , "w"); 

if( fh ) 

{ 

fputs ( "Date,Open,High,Low,Close,Volume\n" , fh ); 

y = Year (); 
m = Month (); 
d = Day (); 

for ( 1=0; 1 < BarCount; i++ ) 

{ 

ds = StrFormat ( "%02.Of-%02.Of-%02.Of, " , 
y[i],m[i],d[i] ); 

fputs ( ds, fh ); 

qs = StrFormat ("%. 4f, %.4f, %.4f, %.4f, %.0f\n", 

0[ i ], H[ i ], L[ i ], C[ i ], V[ 1 ] ); 

fputs ( qs, fh ); 

} 


fclose ( fh ); 

} 


SEE ALSO fopen() function , fclose() function , fgetsQ function 

References: 

The fputs function is used in the following formulas in AFL on-line library: 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• AutoTrade using an Exploration 

• Continuous Contract Rollover 


fputs - write a string to a file 
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• Export All Dally Data to TXT with MS Import format 

• Export EOD or Intraday to .csv file 

• Export Intraday Data 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Herman 

• IBD relative strength database ranker 

• TWS auto-export Executlons-flle parser 

More information: 

Updated on-line reference 


fputs- write a string to a file 
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Math functions 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


frac( NUMBER) 
frac( ARRAY) 

NUMBER, 

ARRAY 

Eliminates the integer portion of NUMBER or ARRAY and returns the fractional part. 
The formula frac( 12.4 ) returns 0.4; the formula frac(-15.7 ) returns -0.7. 


The frac function is used in the following formulas in AFL on-line library: 


Auto Trade Step by Step 

Bullish Percent Index 2 files combined 

CCI 14 DrBobStyle 

CCI 50 DrBob Style 

Continuous Contract Rollover 

Cycle Highlighter 

Cycle Highlighter (auto best-fit) 

Fast Refreshed KAGI Swing Charts (Price Swing) 
Kagi Chart 

Lunar Phases - original 
LunarPhase 

Steve Woods' Cumulative Vol. Percentage Indicator 
Triangle exploration using P&F Chart 
Woodie's CCI Panel Basic 
Woodie's CCI Panel Full Stats 


More information: 


Updated on-line reference 


frac - fractionai part 
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frmdir 

- removes a directory 

SYNTAX frmdirC'dirname") 

RETURNS NUMBER 

FUNCTION This function removes a directory 

"dirname" specifies path of the directory to be removed. Piease note that this function 
removes oniy ONE directory at a time. So if you want to remove nested directory tree you 
have to caii it muitipie times, for exampie: 

frmdir ( "C:\\MyDirectory\\MySubDirectory" ); // delete nested subdir 

first 

frmdir ( "C:\\MyDirectory" ); 

Note that directory must be empty before removing it otherwise it wiii not be possibie to 
remove it. 

Returns TRUE if directory successfuiiy removed, FALSE othen/vise 

EXAMPLE 

SEE ALSO 
References: 

The frmdir function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-iine reference 


File Input/Output functions 

(AFL 2.70) 


frmdir - removes a directory 
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FullName 

- full name of the symbol 


Information / Categories 

(AFL 1.1) 


SYNTAX FullNarneQ 

RETURNS STRING 

FUNCTION The function returns stock full name which is definable by the user in Symbol | Information 
window. 

EXAMPLE printf( fullname()); 

SEE ALSO 
References: 


The FullName function is used in the following formulas in AFL on-line library: 

• Advanced Trend Lines with S & R 

• AFL Example 

• AFL Example - Enhanced 

• babaloo chapora 

• colored CCI 

• Commodity Channel Index 

• Dave Landry PullBack Scan 

• Dinapoli Guru Commentary 

• Double Smoothed Stochastic from W.Bressert 

• DPO with shading 

• Elder Triple Screen Trading System 

• FastStochK FullStochK-D 

• Fibonacci Calculations & Speed Resistance 

• Fre 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• hassan 

• Improved NH-NH scan / indicator 

• MACD commentary 

• MACD Histogram - Change in Direction 

• Market Facilitation Index VS Volume 

• MS Darvas Box with Exploration 

• Nick 

• PF Chart - Close - April 2004 

• Pivot End Of Day Trading System 

• Pivot Finder 

• Point & figure Chart India Securities 

• prakash 

• Relative Strength 

• Scan New High and New Low 

• shailu lunia 

• Steve Woods' Cum. Vol. Float -i- Cum. Vol. Channels 

• Steve Woods' Cumulative Vol. Percentage Indicator 

• Steve Woods' Float Channel Lines 


FullName - full name of the symbol 


705 



AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


• Stochastic Fast%K and Full 

• TD Sequential 

• Triangular Moving Average new 

• William's Alligator System II 

• Woodies CCI 

• ZigZag Retracements 

More information: 

Updated on-line reference 


FullName- full name of the symbol 
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GapDown 
- gap down 

SYNTAX 
RETURNS 
FUNCTION 

EXAMPLE 

SEE ALSO 
References: 

The GapDown function is used in the foiiowing formuias in AFL on-line library: 

• Candle Identification 

• Candle Pattern Function 

• Candle Stick Analysis 

• Candlestick Commentary 

• Candlestick Commentary Modified 

• Candlestick Commentary-modified 

More information: 

Updated on-line reference 


Basic price pattern detection 

GapDownO 

ARRAY 

Gives a "1" or "true" on the day a security's prices gap down. Otherwise the result is "0". A 
gap down occurs if yesterday's low is greater than today's high. 


GapDown - gap down 
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GapUp 
- gap up 

SYNTAX 
RETURNS 
FUNCTION 

EXAMPLE 

SEE ALSO 
References: 

The GapUp function is used in the foiiowing formuias in AFL on-line library: 

• Candle Identification 

• Candle Pattern Function 

• Candle Stick Analysis 

• Candlestick Commentary 

• Candlestick Commentary Modified 

• Candlestick Commentary-modified 

• swing chart 

More information: 

Updated on-line reference 


Basic price pattern detection 

GapUpQ 

ARRAY 

Gives a "1" or "true" on the day a security's prices gap up. Otherwise the result is "0". A gap 
up occurs if yesterday's high is less than today's low. 


GapUp - gap up 
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GetAsyncKeyState 

- query the current state of keyboard keys 

SYNTAX GetAsyncKeyState( vkey) 

RETURNS NUMBER 

FUNCTION The function queries current state of keyboard keys (at the time of the caii). 

GetAsyncKeyState is 100% equivaient of Windows API function of the same name. 

See: http://msdn.microsoft.com/en-us/iibrary/windows/desktop/ms646293(v=vs.85).aspx 
Arguments: 

vkey is virtual key code to query (see table below). 

The function returns 0 if key is NOT pressed and value < 0 (less than zero) when key is 
currently pressed. 

Virtual Key codes: 

vkBackSpace = 8; 
vkTab = 9; 
vk_Return = 13; 
vk_Shift= 16; 
vk_Control = 17; 
vk_Alt= 18; 
vkPause = 19; 
vkCapsLock = 20; 
vkEscape = 27; 
vkSpace = 32; 
vkPageUp = 33; 
vkPageDown = 34; 
vkEnd = 35; 
vkHome = 36; 
vk_Left = 37; 
vk_Up = 38; 
vk_Right = 39; 
vk_Down = 40; 
vk_PrintScreen = 44; 
vkjnsert = 45; 
vk_Delete = 46; 

/* NOTE: vk_0..vk_9 vk_A.. vk_Z match regular ASCII codes for digits and A-Z letters 7 

vk_0 = 48; 
vk_1 = 49; 
vk_2 = 50; 
vk_3 = 51; 
vk_4 = 52; 
vk 5 = 53; 


Miscellaneous functions 

(AFL 3.60) 


GetAsyncKeyState - query the current state of keyboard keys 
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vk_6 = 54; 
vk_7 = 55; 
vk_8 = 56; 
vk_9 = 57; 
vk_A = 65; 
vk_B = 66; 
vk_C = 67; 
vk_D = 68; 
vk_E = 69; 
vk_F = 70; 
vk_G = 71; 
vk_H = 72; 
vkj = 73; 
vk_J = 74; 
vk_K = 75; 
vk_L = 76; 
vk_M = 77; 
vk_N = 78; 
vk_0 = 79; 
vk_P = 80; 
vk_Q = 81; 
vk_R = 82; 
vk_S = 83; 
vk_T = 84; 
vk_U = 85; 
vk_V = 86; 
vk_W = 87; 
vk_X = 88; 
vk_Y = 89; 
vk_Z = 90; 

vk_LWin = 91; 
vk_RWin = 92; 
vkApps = 93; 

/* numerical key pad 7 
vkNumPadO = 96; 
vkNumPadI = 97; 
vk_NumPad2 = 98; 
vk_NumPad3 = 99; 
vk_NumPad4 = 100; 
vk_NumPad5 = 101; 
vk_NumPad6 = 102; 
vk_NumPad7 = 103; 
vk_NumPad8 = 104; 
vk_NumPad9 = 105; 
vk_Multiply = 106; 
vk_Add = 107; 
vkSubtract = 109; 
vk_Decimal = 110; 
vk_Divide = 111; 

/* function keys */ 


GetAsyncKeyState - query the current state of keyboard keys 
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vk_F1 = 112; 
vk_F2 = 113; 
vk_F3 = 114; 
vk_F4= 115; 
vk_F5 = 116; 
vk_F6 = 117; 
vk_F7= 118; 
vk_F8 = 119; 
vk_F9 = 120; 
vk_F10 = 121; 
vk_F11 =122; 
vk_F12 = 123; 
vk_F13 = 124; 
vk_F14 = 125; 
vk_F15 = 126; 
vk_F16 = 127; 

vk_NumLock =144; 
vk_ScrollLock = 145; 
vk_LShift= 160; 
vk_RShift= 161; 
vk_LControl = 162; 
vk_RControl = 163; 
vk_LAIt = 164; 
vk_RAIt= 165; 
vk_SemiColon = 186; 
vk_Equals = 187; 
vkComma = 188; 
vkUnderScore = 189; 
vkPeriod = 190; 
vk_Slash = 191; 
vkBackSlash = 220; 
vk_RightBrace = 221; 
vkLeftBrace = 219; 
vk_Apostrophe = 222; 

EXAMPLE Plot ( C, "Close", colorRed ); 

vk_Shift = 16; 

if ( GetAsyncKeyState ( vk_Shlft ) < 0 ) Title = "Shift is pressed"; 


SEE ALSO 
References: 

The GetAsyncKeyState function is used in the foliowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 


GetAsyncKeyState- query the current state of keyboard keys 
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GetBacktesterObject 
- get the access to backtester object 


Trading system toolbox 

(AFL 2.60) 


SYNTAX GetBacktesterObjectO 

RETURNS OBJECT 

FUNCTION This funciton is used in custom backtester procedures to get the access to backtester object. 
Note that GetBacktester method shouid oniy be caiied when Status("action") returns 
actionPortfoiio. 


For more detaiis piease read Custom Backtester documentation 

EXAMPLE if ( Status ( "action")== actionPortfoiio ) 

{ 

// retrieve the interface to portfolio backtester 
bo = GetBacktesterObjectO; 

//...here is your custom backtest formula. 

} 


SEE ALSO STATUSO function 

References: 


The GetBacktesterObject function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Customised Avg. Profit %, Avg. Loss % etc 

• Detaiied Equity Curve 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• MFE and MAE and piot trades as indicator 

• Rebaiancing Backtest avoiding ieverage 

More information: 


Updated on-iine reference 


GetBacktesterObject - get the access to backtester object 
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GetBaseIndex 

- retrieves symbol of relative strength base index 


Referencing other symbol data 

(AFL 2.1) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


GetBaselndex() 

STRING 

Retrieves base relative-strength index for given security as defined in Symbol->Categories. 
AddTextColumn( GetBaselndex(), "Base index"); 


The GetBaseIndex function is used in the following formulas in AFL on-line library: 

• Dave Landry PullBack Scan 

• Elder Triple Screen Trading System 

• Indicator Explorer (ZigZag) 

More information: 


Updated on-line reference 


GetBaseIndex - retrieves symbol of relative strength base index 
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GetCategorySymbols information / 

- retrieves comma-separated list of symbols belonging to given ^^(afl 2 4 ^ 

GetCategorySymbols( category, index) 

STRING 

IMPORTANT: This function is now avaiiabie under new name of CategoryGetSymbols. The 
old name is left only for backward compatibility. Please use new name in all new codes. 

CategoryGetSymbolsQ function 

The GetCategorySymbols function is used in the following formulas in AFL on-line library: 

• Baseline Relative Performance Watchlist charts V2 

• Count Tickers in Watchlist 

• Ranking and sorting stocks 

• Ranking Ticker Watchlist 

• WLBuildProcess 

More information: 

Updated on-line reference 


category 

SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


GetCategorySymbols - retrieves comma-separated list of symbols belonging to given category 714 
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GetChartBkColor 

- get the RGB color value of chart background 


Indicators 

(AFL 3.20) 


SYNTAX GetChartBkColorO 
RETURNS NUMBER 


FUNCTION Returns color value of chart background. Color value In AmiBroker Is either one of predefined 
color constants (colorWhIte, colorBlack), or RGB value with offset of 56 (number of 
predefined colors). So to get actual RGB value you need to subtract 56 from the result of that 
function. 

EXAMPLE SetChartBkColor ( ParamColor ( "Color" , ColorRGB ( 255, 255, 255 ) ) ) ; 


rgb = GetChartBkColorO - 56; 

red = ( rgb & 255 ); 

green = floor ( (rgb/256) & 255 ); 

blue = floor ( rgb/ (256*256) ) ; 

Title="R="+ red + " G=" + green + " B=" + blue; 


SEE ALSO SetChartBkColorO function , SetChartBkGradlentFIII() function 

References: 

The GetChartBkColor function Is used In the following formulas In AFL on-line library: 
• Stress with SuperSmoother 

More information: 

Updated on-line reference 


GetChartBkColor - get the RGB color value of chart background 
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GetChartID 
- get current chart ID 


Exploration / Indicators 

(AFL 2.3) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


GetChartlDQ 

NUMBER 

returns the chart ID of current indicator formuia. Returns 0 if used in Automatic anaiysis. 
Cross( graphO, Study( "RE", GetChartlD())); 


The GetChartID function is used in the foilowing formulas in AFL on-line library: 

• Continuous Contract Rollover 

• GFX ToolTip 

• Heatmap V1 

• MFE and MAE and plot trades as indicator 

• Now Send Push Notifications From Amibroker 

• Plot visual stop / target ratio. 

More information: 


Updated on-line reference 


GetChartID - get current chart ID 
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GetCursorMouseButtons 
- get current state of mouse buttons 


Indicators 

(AFL 2.80) 


SYNTAX GetCursorMouseButtonsQ 

RETURNS NUMBER 

FUNCTION This function returns mouse button state at the time when chart formuia is executed. 

The state is COMBiNATiON (bitwise OR) of the foiiowing fiags: 

• 0 - if no mouse button is down 

• 1 - if ieft mouse button is down 

• 2 - if right mouse button is down 

• 4 - if middie mouse button is down 

• 8 - if window just received mouse ciick (version 5.06 and higher oniy) 

So for exampie the foiiowing combinations are possibie: 

• 3 - ieft + right down 

• 3 - ieft + right down 

• 5 - ieft + middie down 

• 6 - right + middie down 

• 7 - ieft + right + middie down 

• 9 - ieft mouse button just ciicked (v.5.06) 

• 10 - right mouse button just ciicked (v.5.06) 

• 11 - ieft + right mouse button just ciicked (v.5.06) 

For exampie if you ciick the ieft mouse button and hoid it down, the underiying chart wiii be 
refreshed and GetCursorMouseButtons wiii return 9 (8+1) during very first execution since 
ciick and 1 in aii subsequent executions as iong as ieft mouse button is kept pressed down. 
You need to use bitwise AND (&) to extract these fiags as shown in the exampie. 

EXAMPLE if ( GetCursorMouseButtons () & 1 ) 

{ 

printfC'left mouse button is pressed down" ); 

} 

Exampie 2. Low-ievei graphic + interactive GUi controi sampie 

///////////////////////////////////////////////// 

// Low-level graphic + Interactive GUI control sample 
// This example shows: 


// 

1. 

how 

to 

draw "buttons" 

// 

2 . 

how 

to 

handle mouse clicks 

// 

3 . 

how 

to 

implement event call-backs 


/////////////////////////////////////////////////// 

Version! 5.04 ); // requires 5.04 or higher 

//////////////////////////////////////////////////// 
// Part 1: DRAWING TABLE OF BUTTONS 


GetCursorMouseButtons - get current state of mouse buttons 
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////////////////////////////////////////////////// 

GfxSetOverlayMode ( 2 ); 

// formatted text output sample via low-level gfx functions 

CellHeight = 20; 

CellWidth = 100; 

GfxSelectFont ( "Tahoma", CellHeight/2 ); 

GfxSetBkMode ( 1 ); 

function PrintInCell ( string, row. Col ) 

{ 

GfxDrawText ( string. Col * CellWidth, row * CellHeight, (Col + 1 ) * 
CellWidth, (row + 1 ) * CellHeight, 0 ); 

} 


GfxSelectPen ( colorBlue ); 
for ( 1=0; i < 10 && 1 < BarCount; i++ ) 
{ 

for ( k = 0; k < 5; k++ ) 


PrintInCell( "Button " + 1 + "," + k, 1, k ); 


GfxMoveTo ( 
GfxLineTo ( 
} 

GfxMoveTo ( 
GfxLineTo ( 

for ( Col = 


0,1* CellHeight ); 

5 * CellWidth, 1 * CellHeight ); 

0,1* CellHeight ); 

5 * CellWidth, i * CellHeight ); 

1; Col < 6; Col++ ) 


GfxMoveTo ( Col * CellWidth, 0); 

GfxLineTo ( Col * CellWidth, 10 * CellHeight ); 

} 


///////////////////////////////////////////////////////// 
// Part 2: MOUSE BUTTON CALL BACKS 
////////////////////////////////////////////////////////// 

Title=" "; 


function DrawButton( px, py, Clrl, Clr2, text ) 

{ 

Col = floor ( px / CellWidth ); 

Row = floor ( py / CellHeight ); 


GfxGradientRect ( Col * CellWidth, row * CellHeight, (Col + 1 ) * 
CellWidth, (row + 1 ) * CellHeight, 

Clrl, Clr2 ); 
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PrintInCell ( text + " " + row + + Col, row. Col ); 


function OnLMouseButton(x, y, px, py) 

{ 

_TRACE ( "LButton x = " + DateTlmeToStr ( x ) + " y = " + y ); 

DrawButton( px, py, ColorHSB ( 50, 255, 255 ), ColorHSB ( 90, 255, 
255 ), "just clicked" ); 

} 

function OnRMouseButton(x, y, px, py) 

{ 

_TRACE ( "RButton x = " + DateTlmeToStr ( x ) + " y = " + y ); 

} 


function OnMMouseButton(x, y, px, py) 

{ 

_TRACE ( "MButton x = " + DateTlmeToStr ( x ) + " y = " + y ); 

} 


function OnHoverMouse(x, y, px, py) 

{ 

_TRACE ( "LButton x = " + DateTlmeToStr ( x ) + " y = " + y ); 


DrawButton( px, py, ColorRGB ( 230, 230, 230 ), ColorRGB ( 255, 
255, 255 ), "mouse over" ); 

} 


function OnLButtonIsDown(x, y, px, py) 

{ 

_TRACE ( "LButton x = " + DateTlmeToStr ( x ) + " y = " + y ); 

DrawButton( px, py, ColorHSB ( 190, 255, 255 ), ColorHSB ( 210, 
255, 255 ), "down" ); 

} 

///////////////////////////////////////////////////////// 

// Part 3: GENERAL PURPOSE EVENT HANDLER (reusable! - may be put 
Into "Include" file) 

//////////////////////////////////////////////////////// 

function EventHandler() 

{ 

local b, X, y, px, py; 

b = GetCursorMouseButtons (); 

// retrieve co-ordinates in date/value units 
X = GetCursorXPosition ( 0 ); 
y = GetCursorYPosition ( 0 ); 
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// retrieve co-ordinates in pixel units 
px = GetCursorXPosition ( 1 ); 

PY = GetCursorYPosition ( 1 ); 

if ( b & 8 ) // flag = 8 is set when window just received mouse click 
{ 


// 

not-null 

means clicked in 

. THIS 

(current) window 

if ( 

b & 1 ) 

OnLMouseButton( 

X, y. 

px. 

py ); 

if ( 

b & 2 ) 

OnRMouseButton ( 

X, y. 

px. 

py ); 

if ( 

b & 4 ) 

OnMMouseButton ( 

X, y. 

px. 

py ); 


} 

else 

{ 

if ( b == 0 ) OnHoverMouse ( x, y, px, py ) ; //no button pressed 
if ( b == 1 ) OnLButtonIsDown( x, y, px, py ) ; // button pressed 

} 

} 

EventHandler(); 

RequestTimedRefresh ( 1 ); 

SEE ALSO GetCursorXPositionO function , GetCursorYPosition() function 

References: 

The GetCursorMouseButtons function is used in the foiiowing formuias in AFL on-iine iibrary: 

• GFX ToolTip 

• Fleatmap V1 

• Visi-Trade 

More information: 

Updated on-line reference 
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GetCursorXPosition 

- get current X position of mouse pointer 


Indicators 

(AFL 2.80) 


SYNTAX GetCursorXPosition( mode = 0 ) 

RETURNS NUMBER (datetime) 

FUNCTION Retrieves current mouse pointer X co-ordinate (i.e. datetime of bar under the mouse pointer). 
The functions now (v5.10 and up) by defauit return NULL (empty vaiue) if mouse is 
OUTSIDE the current window 

Parameters: 


• mode = -1 - (oid compatibiiity mode) - x - vaiue gives X-coordinate in DateTime 
format, y - value gives PRICE. Values are reported no matter where is the mouse 
(i.e. may refer to window different than current if mouse is outside current window). 

• mode = 0 - (default) x - value gives X-coordinate in DateTime format, y - value gives 
PRICE. Returns NULL if mouse is outside current window 

• mode = 1 - X, y - are mouse coordinates expressed in screen PIXELS. Returns NULL 
if mouse is outside current window 

Values returned are equal to those visible in the status bar, and these functions require 
status bar to be visible. Returned values represent cursor position at the formula execution 
time (or few milliseconds before it) and accurracy is subject to pixel resolution of the screen 
(first cursor position is read in screen pixels (integer) and then converted to actual value 
therefore for example when screen resolution is 1024x768 maximum obtainable resolution in 
X direction is 0.1% and in Y direction 0.13%), also X values are snap to datetime of nearest 
data bar. 

It only makes sense to use these functions in indicator/interpretation code. 

Using them in AA window may yield random values.GetCursorXPosition() function returns X 
position in DateTime format (the same as used by DateTime() function). You can convert it to 
string using DateTimeToStrQ function.GetCursorYPositionQ returns Y position (as displayed 
in Y axis of the chart). 

EXAMPLE ToolTip = "X=" + DateTimeToStr ( GetCursorXPosition () ) + 

"nY=" + GetCursorYPosition (); 

SEE ALSO GetCursorYPositionO function , GetCursorMouseButtons() function 

References: 


The GetCursorXPosition function is used in the following formulas in AFL on-line library: 

• GFX ToolTip 

• Heatmap VI 

• Visi-Trade 

• Visualization of stoploses and profit in chart 
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More information: 

Updated on-line reference 
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GetCursorYPosition 

- get current Y position of mouse pointer 


Indicators 

(AFL 2.80) 


SYNTAX GetCursorYPositionO 

RETURNS NUMBER 

FUNCTION Retrieves current mouse pointer Y co-ordinate (i.e. vaiue in doiiars or other Y-axis unit). The 
functions now (v5.10 and up) by defauit return NULL (empty vaiue) if mouse is OUTSIDE the 
current window 

Parameters: 


• mode = -1 - (oid compatibiiity mode) - x - vaiue gives X-coordinate in DateTime 
format, y - value gives PRICE. Values are reported no matter where is the mouse 
(i.e. may refer to window different than current if mouse is outside current window). 

• mode = 0 - (default) x - value gives X-coordinate in DateTime format, y - value gives 
PRICE. Returns NULL if mouse is outside current window 

• mode = 1 - X, y - are mouse coordinates expressed in screen PIXELS. Returns NULL 
if mouse is outside current window 

Values returned are equal to those visible in the status bar, and these functions require 
status bar to be visible. Returned values represent cursor position at the formula execution 
time (or few milliseconds before it) and accurracy is subject to pixel resolution of the screen 
(first cursor position is read in screen pixels (integer) and then converted to actual value 
therefore for example when screen resolution is 1024x768 maximum obtainable resolution in 
X direction is 0.1% and in Y direction 0.13%), also X values are snap to datetime of nearest 
data bar. 

It only makes sense to use these functions in indicator/interpretation code. 

Using them in AA window may yield random values.GetCursorXPosition() function returns X 
position in DateTime format (the same as used by DateTime() function). You can convert it to 
string using DateTimeToStrQ function.GetCursorYPositionQ returns Y position (as displayed 
in Y axis of the chart). 

EXAMPLE ToolTip = "X=" + DateTimeToStr ( GetCursorXPosition () ) + 

"nY=" + GetCursorYPositionO; 

SEE ALSO GetCursorYPositionO function , GetCursorMouseButtons() function 

References: 


The GetCursorYPosition function is used in the following formulas in AFL on-line library: 

• GFX ToolTip 

• Heatmap VI 

• Visi-Trade 

• Visualization of stoploses and profit in chart 
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More information: 

Updated on-line reference 
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- retrieves folder name of current database 


AmiBroker Formuia Language (AFL) 

Information / Categories 

(AFL 2.3) 


SYNTAX GetDatabaseNameO 

RETURNS STRING 

FUNCTION retrieves the name of the database - the last part (folder) of the database path 

EXAMPLE 

SEE ALSO 
References: 

The GetDatabaseName function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 
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GetExtraData 

- get extra data from external data source 


Miscellaneous functions 

(AFL 1.9) 


SYNTAX GetExtraDataC'fieldname") 

RETURNS NUMBER or ARRAY or STRING 

FUNCTION Retrieves data-source specific data. 

Currentiy oniy Quotes Pius and TC2000 piug-isn support this function. 
The iist of fieids avaiiabie via QP2 piug-in: 


• "AnnDividend" 

• "Shares" 

• "SharesFioat" 

• "IssueType" (string) 

• "SharesOut" 

• "SharesShort" 

• "TTMsaies" 

• "Beta" 

• "TTMEps" 

• "HiPERange" 

• "LoPERange" 

• "PEG" 

• "InstHoids" 

• "LTDebtToEq" 

• "CashFiowPerShare" 

• "ROE" 

• "TTMSaies" 

• "Yrl EPSGrowth" 

• "YrSEPSGrowth" 

• "YrlProjEPSGrowth" 

• "Yr2ProjEPSGrowth" 

• "Yr3to5ProjEPSGrowth" 

• "BookVaiuePerShare" 

• "Briefing" (string) 

• "QRS" (array) 

• "HasOptions" 

• "EPSRank" (array) - requires QP piugin 1.4.3 

• "Saies" (array) - requires QP piugin 1.5.0 

• "EPS" (array) - requires QP piugin 1.5.0 

• "LastMainDate" - (number) date of iast update of given symboi in YYYYMMDD 
format - requires QP piugin 1.5.1 

• "Exchange" - (string) - exchange code - requires QP piugin 1.5.1 

• "ExchangeSub" - (string) exchange sub-code - requires QP piugin 1.5.1 

• "Fiags" - (string) - requires QP piugin 1.5.1 

• "MarginFiag" - (string)- requires QP piugin 1.5.1 

• "CUSIP" - (string) - requires QP piugin 1.5.1 

• "SIC" - (string) - requires QP piugin 1.5.1 

• "IssueStatus" - (string) - with defauit settings aii symbois shouid have issue status = 
0 other possibie vaiues: 0 = actively trading; 1, P = trading on a when issued basis, 
5, 6, 7, A, B, C, D, E, M = not trading 4, N = new symbol, G, K, X, R, Z = changes to 
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symbol, cusip, name, etc. - requires QP plugin 1.5.1 
The list of fields available via TC2000 plug-in: 

• "BOP" - balance of power indicator 

• "MoneyStream" - money stream indicator 

EXAMPLE GetExtraDataC'briefing"); /* gives briefing text (STRING) 7 

graphO = GetExtraData("QRS"); /‘gives Quotes Plus relative strength (ARRAY) 7 

SEE ALSO 
References: 

The GetExtraData function is used in the following formulas in AFL on-line library: 

• Steve Woods' Cum. Vol. Float -i- Cum. Vol. Channels 

• Steve Woods' Cumulative Vol. Percentage Indicator 

• Steve Woods' Float Channel Lines 

More information: 

Updated on-line reference 
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GetFnData 

- get fundamental data 


Information / Categories 

(AFL 2.90) 


SYNTAX GetFnData( "field") 

RETURNS NUMBER or STRING 

FUNCTION GetFnData allows accessing fundamental data from Information window (Window->Symbol 
Information) "field" parameter can be one of the following: 

• "EPS" 

• "EPSEstCurrentYear" 

• "EPSEstNextYear" 

• "EPSEstNextQuarter" 

• "PEGRatio" 

• "SharesFloat" 

• "SharesOut" 

• "DividendPayDate" 

• "ExDividendDate" 

• "BookValuePerShare" 

• "DividendPerShare" 

• "ProfitMargin" 

• "OperatingMargin" 

• "OneYearTargetPrice" 

• "ReturnOnAssets" 

• "ReturnOnEquity" 

• "QtrlyRevenueGrowth" 

• "GrossProfitPerShare" 

• "SalesPerShare" 

• "EBlTDAPerShare" 

• "QtrlyEarningsGrowth" 

• "InsiderFloldPercent" 

• "InstitutionHoldPercent" 

• "SharesShort" 

• "SharesShortPrevMonth" 

• "ForwardDividendPerShare" 

• "ForwardEPS" 

• "OperatingCashFlow" 

• "LeveredFreeCashFlow" 

• "Beta" 

• "LastSplitRatio" 

• "LastSplitDate" 

• "Alias" (returns symbol alias - string) - 5.50 and above 

• "Address" (returns symbol address - string) - 5.50 and above 

• "Country" (returns symbol country - string) - 5.60 and above 

• "DelistingDate" returns symbol delisting date (as datetime) - 5.70 and above 

EXAMPLE AddColumn ( Close / GetFnData ( "EPS" ) , "Current P/E ratio" ); 

AddColumn ( Close / GetFnData ( "EPSEstNextYear" ) , "Est. Next Year 
P/E ratio" ); 

Filter = Status ("lastbarinrange") ; 
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SEE ALSO GetRTDataO function , GetRTDataForeign() function 

References: 

The GetFnData function is used in the foiiowing formuias in AFL on-line library: 

• ICHIMOKU SIGNAL TRADER 

• Price Chart - Fundamental 

More information: 

Updated on-line reference 
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GetFormulaPath 
- get file path of current formula 


Miscellaneous functions 

(AFL 3.90) 


SYNTAX GetFormulaPathO 

RETURNS STRING 

FUNCTION The function returns full file path of current formula 

EXAMPLE 

SEE ALSO 
References: 

The GetFormulaPath function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 
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GetOption 

- gets the value of option in automatic analysis settings 


Trading system toolbox 

(AFL 2.60) 


SYNTAX GetOptionC'fieldname") 

RETURNS NUMBER 

FUNCTION Gets the value of various options in automatic analysis settings. 

field - is a string that defines the option to read. There are following options available: 

• "NoDefaultColumns" - if set to True - exploration does not have default Ticker and 
Date/Time columns 

• "InitialEquity" 

• "AllowSameBarExit" 

• "ActivateStopsImmediately" 

• "AllowPositionShrinking" 

• "FuturesMode" 

• "InterestRate" 

• "ApplyTo" - returns Analysis "Apply To" setting 0 - all symbols, 1 - current symbol, 2 - 
filter 

• "Filterincludeindex", "FilterIncludeFavorite", "FilterIncludeMarket", 
"FilterIncludeGroup", "FilterIncludeSector", "Filterincludeindustry", 
"FilterIncludeWatchlist" - return "Include" filter settings -1 - means NOT selected (not 
included), >= 0 index of included category 

• "FilterExcludeIndex", "FilterExcludeFavorite", "FilterExcludeMarket", 
"FilterExcludeGroup", "FilterExcludeSector", "FilterExcludeIndustry", 
"FilterExcludeWatchlist" - return "Exclude" filter settings 

• -1 - means NOT selected (not excluded), >= 0 index of excluded category 
"BuyDelay", "SellDelay", "ShortDelay", "CoverDelay" (new in 5.90) - retrieves trade 
delays 

• "MaxOpenPositions" - maximum number of simiutaneously open positions (trades) in 
portfolio backtest/optimization 

• "WorstRankHeld" - the worst rank of symbol to be held in rotational trading mode 
(see EnableRotationalTrading for more details) 

• "MinShares" - the minimum number of shares required to open the position in the 
backtester/optimizer. If you don't have enough funds to purchase that many, trade 
will NOT be entered 

• "MinPosValue" - (4.70.3 and above) the minimum dollar amount required to open the 
position in the backtester/optimizer. If you don't have enough funds trade will NOT be 
entered 

• "PriceBoundChecking" - if set to False - disables checking and adjusting 
buyprice/sellprice/coverprice/shortprice arrays to current symbol High-Low range. 

• CommissionMode - 

0 - use portfolio manager commission table 

1 - percent of trade 

2 - $ per trade 

3 - $ per share/contract 

• CommissionAmount - amount of commission in modes 1 ..3 

• AccountMargin (in old versios it was 'MarginRequirement') - account margin 
requirement (as in settings), 100 = no margin 
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• ReverseSignalForcesExit - reverse entry signal forces exit of existing trade (default = 
True ) 

• UsePrevBarEquityForPosSizing - Affects how percent of current equity position 
sizing is performed. 

False (default value) means: use current (intraday) equity to perform position sizing, 
True means: use previous bar closing equity to perform position sizing 

• PortfolioReportMode - sets backtester report mode: 

0 - trade list 

1 - detailed log 

2 - summary 

3 - no output (custom only) 

• UseCustomBacktestProc - True/False - allows to turn on/off custom backtest 
procedure 

• EveryBarNullCheck - allows to turn on checking for Nulls in arithmetic operations on 
every bar in the array(by default it is OFF - i.e. AmiBroker checks for nulls that 
appear in the beginning of the arrayand in the end of the array and once non-null 
value is detected it assumes no further holes (nulls) in the middle). Turning 
"EveryBarNullCheck" to True allows to extend these checks to each and every 
barwhich is the way 4.74.x and earlier versions worked. 

Note however that turning it on gives huge performance penalty (arithmetic 
operations are performed even 4x slower when this option is ON, so don't use it 
unless you really have to). 

• FloldMinBars - Number - if set to value > 0 - it disables exit during user-specified 
number of bars even if signals/stops are generated during that period 

• EarlyExitBars - Number if set to value > 0 - causes that special early exit 
(redemption) fee is charged if trade is exited during this period 

• EarlyExitFee - defines the % (percent) value of early exit fee 

• FloldMinDays - Number - if set to value > 0 - it disables exit during user-specified 
number of CALENDAR DAYS (not bars) even if signals/stops are generated during 
that period 

• EarlyExitDays - Number if set to value > 0 - causes that special early exit 
(redemption) fee is charged if trade is exited during the period specified in calendar 
days (not bars). 

• DisableRuinStop - it set to TRUE built-in ruin stop is disabled 

• Generate report - allows to suppress/force generation of backtest report. Allowable 
values: 0, 1, or 2 

By default backtest reports are generated ONLY for portfolio backtests and for 
individual backtests if individual reporting is turned on in the settings. Reports are 
disabled for optimization. 

Now with the SetOption() function you can either supress report generation for 
backtests or enable report generation during certain optimization steps, all from code 
level. 

SetOption("GenerateReport", 0 ); // suppress generation of report 
SetOption("GenerateReport", 1 ); // force generation of full report 
SetOption("GenerateReport", 2 ); // only one-line report is generated (in results.rist 
file) viewable as single line in Report Explorer 

• SeparateLongShortRank - True/False 

When separate long/short ranking is enabled, the backtester maintains TWO 
separate "top-ranked" signal lists, one for long signals and one for short signals. This 
ensures that long and short candidates are independently even if position score is 
not symetrical (for example when long candidates have very high positive scores 
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while short candidates have only fractional negative scores). That contrasts with the 
default mode where only absolute value of position score matters, therefore one side 
(long/short) may completely dominate ranking if score values are asymetrical. 

When SeparateLongShortRank is enabled, in the second phase of backtest, two 
separate ranking lists are interleaved to form final signal list by first taking top ranked 
long, then top ranked short, then 2nd top ranked long, then 2nd top ranked short, 
then 3rd top ranked long and 3rd top ranked short, and so on... (as long as signals 
exist in BOTH long/short lists, if there is no more signals of given kind, then 
remaining signals from either long or short lists are appended) 

For example: Entry signals(score):ESRX=Buy(60.93), GILD=Short(-47.56), 
CELG=Buy(57.68), MRVL=Short(-10.75), ADBE=Buy(34.75), VRTX=Buy(15.55), 
SIRI=Buy(2.79), 

As you can see Short signals get interleaved between Long signals even though 
their absolute values of scores are smaller than corresponding scores of long 
signals. Also there were only 2 short signals for that particular bar so, the rest of the 
list shows long signals in order of position score 

Although this feature can be used independently, it is intended to be used in 
combination with MaxOpenLong and MaxOpenShort options. 

• MaxOpenLong - limits the number of LONG positions that can be open 
simultaneously 

• MaxOpenShort - limits the number of SHORT positions that can be open 
simultaneously 

The value of ZERO (default) means NO LIMIT. If both MaxOpenLong and 
MaxOpenShort are set to zero ( or not defined at all) the backtester works old way - 
there is only global limit active (MaxOpenPositions) regardless of type of trade. 

Note that these limits are independent from global limit (MaxOpenPositions). This 
means that MaxOpenLong + MaxOpenShort may or may not be equal to 
MaxOpenPositions. 

If MaxOpenLong + MaxOpenShort is greater than MaxOpenPositions then total 
number of positions allowed will not exceed MaxOpenPositions, and individual 
long/short limits will apply too. For example if your system MaxOpenLong is set to 7 
and maxOpenShort is set to 7 and MaxOpenPositions is set to 10 and your system 
generated 20 signals: 9 long (highest ranked) and 11 short, it will open 7 long and 3 
shorts. 

If MaxOpenLong + MaxOpenShort is smaller than MaxOpenPositions (but greater 
than zero), the system won't be able to open more than 
(MaxOpenLong+MaxOpenShort). 

Please also note that MaxOpenLong and MaxOpenShort only cap the number of 
open positions of given type (long/short). They do NOT affect the way ranking is 
made. I.e. by default ranking is performed using ABSOLUTE value of positionscore. 

If your position score is NOT symetrical, this may mean that you are not getting 
desired top-ranked signals from one side. Therefore, to fully utilise MaxOpenLong 
and MaxOpenShort in rotational balanced ("market neutral") long/short systems it is 
desired to perform SEPARATE ranking for long signals and short signals. 

To enable separate long/short ranking use: 

SetOption("SeparateLongShortRank", True ); 

• RefreshWhenCompleted - when set to TRUE, it will perform View->Refresh All after 
Automatic-Analysis operation (scan/exploration/backtest/optimize) is completed. 

• RequireDeclarations - when set to TRUE the AFL engine will always require variable 
declarations (using local/global) on formula-by-formula basis 
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• ExtraColumnsLocation - allows the user to change the location of custom columns 
added during backtest/optimizatlon. 

"extra" columns mean: 

a) any custom metrics added using custom backtester 

b) any optimization parameters defined using Optlmlze() function 

If both custom metrics and optimization parameters are present then custom metrics 
appear first then optimization parameters 

This function Is provided to allow the user to change the default "at the end" location 
of custom columns/optimization parameters. 

For example: 

SetOptlon("ExtraColumnsLocatlon", 1 ); 

will cause that custom metrics and opt params will be subsequently added starting 
from column 1 (as opposed to last column default) 

Note that this setting changes "visual" order of columns, not really In-memory order 
or export order, so exported data files or copy/paste format do not change. 

• SettlementDelay - this option describes the number of days (not bars) It takes for 
sale proceeds to settle and be available for opening new positions. 

SetOptlon("SettlementDelay", 3 ); // this will cause that proceeds from sale are only 
available for trading on 3rd day after sale 

For detailed tracking " Detailed log" report option now shows available and unsettled 
funds for T-i-1, T-i-2 and so on 

Note: when using this option It Is recommended to use backtestRegularRaw Instead 
of backtestRegular, otherwise some trades may not be entered because funds are 
not settled Immediately and you need to be able to enter not on first but subsequent 
buy signals and that Is exactly what backtestRegularRaw offers. 

Note2: old backtester (EquItyO function) Ignores settlement delay 

• StatIcVarAutoSave - allow periodical auto-savIng of persistent static variables (In 
addition to saving on exit, which Is always done). 

The Interval Is given In seconds. 

For example: 

SetOptlon("StatIcVarAutoSave", 60 ); // auto-save persistent variables every 60 
seconds (1-minute) 

It Is Important to understand that persistent variables are saved ON EXIT 
automatically, without any user Intervention so It should be enough for most cases. If 
you for some reason want auto-saves when AmiBroker Is running, then you can use 
this function. Please note that writing many static variables Into physical disk file 
takes time and It blocks all static variable access so you should AVOID specifying 
too small auto-save Intervals. Saving every second Is bad Idea - It will cause 
overload. Saving every 60 seconds should be fine. Calling function with Interval set 
to zero disables auto-save. 

SetOptlon ("StatIcVarAutoSave", 0); 
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• MCEnable - controls Monte Carlo simulation: 0 - disabled, 1 - enabled in backtests, 2 
- enabled in backtests and optimizations 

• MCRuns - number of Monte Carlo simulation runs (realizations) default 1000 

• MCPosSizeMethod - Monte Carlo position size method: 0 - don't change, 1 - fixed 
size, 2 - constant amount, 3 - percent of equity 

• MCPosSizeShares - number of shares per trade in MC simulation 

• MCPosSizeValue - dollar value per trade in MC simulation 

• MCPosSizePctEquity - percent of current equity per trade in MC simulation 

• MCChartEquityCurves - true/false (1/0) - enables Monte Carlo equity chart 

• MCStrawBroomLines - defines number of equity lines drawn in Monte Carlo straw 
broom chart 

EXAMPLE 

InitialEquity = GetOption ( "InitialEquity" ); 

SEE ALSO 

References: 

SetOptionO function 


The GetOption function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-line reference 
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GetPerformanceCounter 

- retrieves the current value of the high-resolution performance 


Miscellaneous 


functions 

(AFL 2.90) 


counter 

SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


GetPerformanceCounter( bReset = False ) 

NUMBER 

GetPerformanceCounter retrieves the current value of the high-resolution performance 
counter. Returned value is in milliseconds. Resolution is upto 0.001 ms (1 microsecond). The 
value of high-resolution counter represents number of milliseconds from either system start 
(boot) or from last counter reset. To reset the counter you need to call 
GetPerformanceCounter function with bReset parameter set to True. 

Note that reseting counters inside one formula does not affect counters in other formulas. 
Since returned values are very large (time in milliseconds since system start is usually quite 
large), for precise measurements of single function or small function block execution times it 
is strongly recommended to reset counter at the beginning of the block so floating point 
resolution (7 digits) does not affect the precision of measurement. 

GetPerformanceCounter function can be also used in trading system automation to measure 
time in milliseconds between various events (just subtract values returned by 
GetPerformanceCounterO during two different events) 

Caveat: this function relies on Windows API QueryPerformanceCounter function and CPU 
RTDSC instruction and it may yield to inaccurrate results if you have multiple-core processor 
and AMD's "Cool and Quiet" enabled in BIOS or other CPU clock stepping technologies 
enabled. If this applies to you, you may check Microsoft hotfix to this problem at: 
http://support.microsoft.com/?id=896256 

//////////////////////////////// 

// EXAMPLE 1 

// The code shows that 1000 iterations of sin() calculation 
// takes about 1.7 milliseconds. 

// Note that call to the GetPerformanceCounterO 
// has overhead of about 0.015 ms (15 microseconds) 

GetPerformanceCounter (True); // reset counter to zero 
for ( 1=0; i < 1000; i++ ) 

{ 

k = sin ( i ); 

} 

elapsed=GetPerf ormanceCounter () ; 

"Time [ms] = "telapsed; 


counter 

SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


//////////////////////////////// 
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11 EXAMPLE 2 

// GetPerformanceCounter function 

// may also be used to report time since system start. 
elapsed=GetPerf ormanceCounter () ; 

StrFormat ( "Time since system start %.0f days, %.0f hours, %.0f 

minutes, %.0f seconds, %.0f milliseconds ", 

floor (elapsed/(24*60*60*1000)), 

floor ( elapsed/(60*60*1000) ) % 24, 

floor ( elapsed/(60*1000) ) % 60, 

floor ( elapsed/1000 ) % 60, 

elapsed % 1000 ); 


SEE ALSO 
References: 

The GetPerformanceCounter function is used in the foilowing formulas in AFL on-line library: 

• Animated BackGround 

• Animated BackGround 1.1 

• AutoTrade using an Exploration 

• Fleatmap VI 

More information: 

Updated on-line reference 
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GetPlaybackDateTime Date/Time 

- get bar replay position date/time ^ 


SYNTAX 

GetPlaybackDateTimeO 

RETURNS 

NUMBER 

FUNCTION 

The function returns bar replay playback position in datetime format, or zero if bar replay is 
NOT active 

EXAMPLE 

pt = GetPlaybackDateTimeO; // new function to retrieve playback 
position date/time, 

//returns zero if bar replay is NOT active 

if ( pt ) 

{ 

Title = "Playback time: " + DateTimeToStr ( pt ); 

} 

else 

{ 

Title = "Bar Replay not active"; 

} 

SEE ALSO 

DateTimeO function , DateTimeConvertQ function , DateTimeToStr() function 

References: 



The GetPlaybackDateTime function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


GetPlaybackDateTime - get bar replay position date/time 
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GetPriceStyle 

- get current price chart style 


Exploration / Indicators 

(AFL 2.70) 


SYNTAX GetPriceStyle 
RETURNS NUMBER 


FUNCTION Returns price chart style value to be used in Plot statement Returned value depends on 
selection in View->Price chart style menu 

EXAMPLE Plot ( C, "Close", ParamColor ( "Color " , colorBlack ), styleNoTitle 

ParamStyle ( "Style" ) | GetPriceStyle () ) ; 

SEE ALSO 
References: 


The GetPriceStyle function is used in the following formulas in AFL on-line library: 

• Advisory NRx price chart display. 

• Average Price Crossover 

• babaloo chapora 

• changing period moving average 

• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• Colorfull Price 

• Coppock Trade Signal on Price Chart 

• Daily High Low in Advance 

• Dave Landry PullBack Scan 

• DEBAJ 

• DiNapolis 3x Displaced Moving Averages 

• Elder Triple Screen Trading System 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Fibonacci Moving averages 

• Gann level plotter 

• HH-LL-PriceBar 

• ICHIMOKU SIGNAL TRADER 

• interactively test discretionary trading 

• Intraday Fibonacii Trend Break System 

• Intraday Strength 

• Intraday Trend Break System 

• Last Five Trades Result Dashboard - AFL code 

• LunarPhase 

• MS Darvas Box with Exploration 

• nifty 

• Perceptron 

• Pivot End Of Day Trading System 

• plot tomorrows pivots on an intraday database 

• prakash 

• Price Chart - Fundamental 

• PVT Trend Decider 

• Rebalancing Backtest avoiding leverage 

• SAR-ForNextBarStop 


GetPriceStyle - get current price chart style 
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• Square of Nine Roadmap Charts 

• Super Trend Indicator 

• suresh 

• TrendingRibbonArrowsADX 

• Vikram's Floor Pivot Intraday System 

• Visible Min and Max Value Demo 

• William's Alligator System II 

• WILSON RELATIVE PRICE CHANNEL 

• Zig-Hi Zap-Lo 

More information: 

Updated on-line reference 


GetPriceStyle- get current price chart style 
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GetRTData 

- retrieves the real-time data fields 


Miscellaneous functions 

(AFL 2.60) 


SYNTAX GetRTDataC'fieldname") 

RETURNS NUMBER 

FUNCTION Retrieves the LAST (the most recent) value of the following fields reported by streaming real 
time data source: 

• "Ask" - current best ask price 

• "AskSize " - current ask size 

• "Bid" - current best bid price 

• "BidSize " - current bid size 

• "52WeekHigh" - 52 week high value 

• "52WeekHighDate" - 52 week high date (in datenum format) 

• "52WeekLow" - 52 week low value 

• "52WeekLowDate" - 52 week low date (in datenum format) 

• "Change" - change since yesterdays close 

• "Dividend" - last dividend value 

• "DivYield" - dividend yield 

• "EPS" - earnings per share 

• "High" - current day's high price 

• "Low" - current day's low price 

• "Open" - current day's open price 

• "Last" - last trade price 

• "Openint" - current open interest 

• "Prev" - previous day close 

• "TotalVolume" - total today's volume 

• "TradeVolume" - last trade volume 

• "ChangeDate" - datenum (YYYMMDD) of last data change 

• "ChangeTime" - timenum (HHMMSS) of last data change 

• "UpdateDate" - datenum (YYYMMDD) of last data update 

• "UpdateTime" - timenum (HHMMSS) of last data update 

• "Shares" - total number of shares 

Note 1: this function is available ONLY in PROFESSIONAL edition, calling it using Standard 
edition will give you NULL values for all fields 

Note 2: works only if data source uses real time data source (plugin) 

Note 3: availablity of data depends on underlying data source - check the real-time quote 
window to see if given field is available 

Note 4: function result represents the current value at the time of the call /formula execution/, 
and they will be refreshed depending on chart or commentary refresh interval /settable in 
preferences/. Built-in real time quote window is refreshed way more often (at least 10 times 
per second) 

EXAMPLE "Bid = "+GetRTData ( "Bid" ); 

"Ask = "+GetRTData ("Ask") ; 


GetRTData - retrieves the real-time data fields 
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"Last = "+GetRTData ( "Last" ); 

"Vol = "+GetRTData ( "TradeVolume" ); 

"EPS = "+GetRTData ("EPS") ; 

"52week. high = "+GetRTData ( "52weekhigh" ) ; 

SEE ALSO GetRTDataForeignO function 

References: 

The GetRTData function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Bid Vs Ask Dashboard 
More information: 

Updated on-iine reference 


GetRTData- retrieves the real-time data fields 
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GetRTDataForeign 

- retrieves the real-time data fields (for specified symbol) 


Miscellaneous functions 

(AFL 2.80) 


SYNTAX GetRTDataForeign( "fieldname" , "symbol" ) 

RETURNS NUMBER 

FUNCTION This function is simiiar to GetRTData but aiiows to specify symboi OTFiER than currentiy 
seiected and it is much faster than SetForeign/GetRTData combo. 

The function retrieves the LAST (the most recent) vaiue of the foiiowing fieids reported by 
streaming reai time data source for specified symboi: 

• "Ask" - current best ask price 

• "AskSize " - current ask size 

• "Bid" - current best bid price 

• "BidSize " - current bid size 

• "52WeekFiigh" - 52 week high vaiue 

• "52WeekFiighDate" - 52 week high date (in datenum format) 

• "52WeekLow" - 52 week iow vaiue 

• "52WeekLowDate" - 52 week iow date (in datenum format) 

• "Change" - change since yesterdays ciose 

• "Dividend" - iast dividend vaiue 

• "DivYieid" - dividend yieid 

• "EPS" - earnings per share 

• "Fiigh" - current day's high price 

• "Low" - current day's iow price 

• "Open" - current day's open price 

• "Last" - iast trade price 

• "Openint" - current open interest 

• "Prev" - previous day ciose 

• "TotaiVoiume" - totai today's voiume 

• "TradeVoiume" - iast trade voiume 

• "ChangeDate" - datenum (YYYMMDD) of iast data change 

• "ChangeTime" - timenum (FiFiMMSS) of iast data change 

• "UpdateDate" - datenum (YYYMMDD) of iast data update 

• "UpdateTime" - timenum (FiFiMMSS) of iast data update 

• "Shares" - totai number of shares 

Note 1: this function is avaiiabie ONLY in PROFESSiONAL edition, caiiing it using Standard 
edition wiii give you NULL vaiues for aii fieids 

Note 2: works oniy if data source uses reai time data source (piugin) 

Note 3: avaiiabiity of data depends on underiying data source - check the reai-time quote 
window to see if given fieid is avaiiabie 

Note 4: function resuit represents the current vaiue at the time of the caii /formuia execution/, 
and they wiii be refreshed depending on chart or commentary refresh intervai /settabie in 
preferences/. Buiit-in reai time quote window is refreshed way more often (at ieast 10 times 
per second) 


GetRTDataForeign - retrieves the real-time data fields (for specified symbol) 
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EXAMPLE "Bid = "+GetRTDataForeign ( "Bid" ); 

"Ask = "+GetRTData ( "Ask" ); 

"Last = "+GetRTData ( "Last" ); 

"Vol = "+GetRTData ( "TradeVolume" ); 

"EPS = "+GetRTDataForeign ("EPS", "AAPL"); 

"52week high = "+GetRTDataForeign ( "52weekhigh", "MSFT"); 

SEE ALSO GetRTDataO function , SetForeign() function 

References: 

The GetRTDataForeign function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Fleatmap V1 
More information: 

Updated on-iine reference 


GetRTDataForeign- retrieves the real-time data fields (for specified symbol) 
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GetScriptObject 

- get access to script COM object 


Miscellaneous functions 

(AFL 1.8) 


SYNTAX getscriptobject() 

RETURNS OBJECT 

FUNCTION Retrieves AFL host's script object. This aiiows to caii functions defined in JScript/VBScript 

directiy from AFL. 

EXAMPLE EnabieScriptC'jscript") 

function MyAdd(x, y) 

{ 

return x+y; 

} 

%> 

script = GetScriptObjectO; 

WriteVai( script.MyAdd( 7, 9 )); // caii the function defined in JScript 

SEE ALSO 
References: 


The GetScriptObject function is used in the foliowing formulas in AFL on-line library: 

• accum/dist mov avg crossover SAR 

• AR_Prediction.afl 

• Heatmap VI 

• Now Send Push Notifications From Amibroker 

• nth (1 - 8 ) Order Polynomial Fit 

• Polarized Fractal Efficiency 

• Standard Error Bands 

• tomy_frenchy 

• Trigonometric Fit - TrigFit with AR for cos / sin 

More information: 

Updated on-line reference 


GetScriptObject - get access to script COM object 
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GetT radinginterface 

- retrieves OLE automation object to automatic trading interfac 


Trading system 
toolbox 

(AFL 2.70) 


SYNTAX GetTradinglnterface( 

RETURNS OBJECT 

FUNCTION Retrieves OLE automation object to automatic trading interface. "Name" is the interface 

name. You have to have trading interface instaiied separateiy to make it work otherwise you 
wili get the error message attempting to use this function. Trading interface for Interactive 
Brokers is availabie from download section: http://www.amibroker.com/download.html 

EXAMPLE 

SEE ALSO 
References: 

The GetTradinginterface function is used in the following formulas in AFL on-line library: 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Button trading using AB auto trading interface 

• Manual Bracket Order Trader 

• Moving Averages NoX 

• Visi-Trade 

More information: 

Updated on-line reference 


GetTradingInterface - retrieves OLE automation object to automatic trading interfac 
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GfxArc 
- draw an arc 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxArc( x1, y1, x2, y2, x3, y3, x4, y4 ) 

RETURNS NOTHING 

FUNCTION Draws an elliptical arc. The arc drawn by using the function is a segment of the ellipse 
defined by the specified bounding rectangle. 


The actual starting point of the arc is the point at which a ray drawn from the center of the 
bounding rectangle through the specified starting point intersects the ellipse. The actual 
ending point of the arc is the point at which a ray drawn from the center of the bounding 
rectangle through the specified ending point intersects the ellipse. The arc is drawn in a 
counterclockwise direction. 

Parameters 

• x1 - x-coordinate of the upper left corner of the bounding rectangle 

• y1 - y-coordinate of the upper left corner of the bounding rectangle 

• x2 - x-coordinate of the lower right corner of the bounding rectangle 

• y2 - y-coordinate of the lower right corner of the bounding rectangle 

• x3 - x-coordinate of the arc's starting point. 

• y3 - y-coordinate of the arc's starting point. 

• x4 - x-coordinate of the arc's ending point. 

• y4 - y-coordinate of the arc's ending point. 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 


EXAMPLE 

GfxSelectPen ( colorRed ) ; 

GfxArc (100,0,200,100,150,0,200, 50) ; 

SEE ALSO GfxChordO function , GfxPie() function , GfxSelectPen() function 

References: 


The GfxArc function is used in the following formulas in AFL on-line library: 


More information: 


Updated on-line reference 


GfxArc - draw an arc 
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GfxChord Low-level graphics 

- draw a chord ^ 


SYNTAX GfxChord( x1, y1, x2, y2, x3, y3, x4, y4 ) 

RETURNS NOTHING 

FUNCTION Draws a chord (a closed figure bounded by the intersection of an eiiipse and a iine segment). 
The (x1, y1) and (x2, y2) parameters specify the upper-ieft and iower-right corners, 
respectiveiy, of a rectangie bounding the eiiipse that is part of the chord. The (x3, y3) and 
(x4, y4) parameters specify the endpoints of a iine that intersects the eiiipse. The chord is 
drawn by using the seiected pen and fiiied by using the seiected brush. 


Parameters 

• x1 - x-coordinate of the upper left corner of the bounding rectangle 

• y1 - y-coordinate of the upper left corner of the bounding rectangle 

• x2 - x-coordinate of the lower right corner of the bounding rectangle 

• y2 - y-coordinate of the lower right corner of the bounding rectangle 

• x3 - x-coordinate of the chord's starting point. 

• y3 - y-coordinate of the chord's starting point. 

• x4 - x-coordinate of the chord's ending point. 

• y4 - y-coordinate of the chord's ending point. 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxSelectPen ( colorRed ) ; 

GfxSelectSolidBrush ( colorBlue ) ; 

GfxChord (100, 0,200,100,150,0,200, 50); 


SEE ALSO GfxSelectPenO function , GfxSelectSolidBrush() function , GfxPie() function 

References: 

The GfxChord function is used in the following formulas in AFL on-line library: 

More Information: 

Updated on-line reference 


GfxChord -draw a chord 
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GfxCircle 
- draw a circle 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxClrcle( x, y, radius ) 

RETURNS NOTHING 

FUNCTION Draws a circle. The center of the circle is given by x and y parameters. The circle is drawn 
with the current pen, and its interior is filled with the current brush. 

Parameters 


• X - x-coordinate of the center of the circle 

• y - y-coordinate of the the center of the circle 

• radius - radius of the circle 


This function is essentially the same as GfxEllipse( x - radius, y - radius, x + radius, y + 
radius); 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxCircle( 100, 100, 50 ); 

SEE ALSO GfxEllipseO function , GfxRoundRect() function , GfxSelectPen() function , 
GfxSelectSolidBrushO function 

References: 


The GfxCircle function is used in the following formulas in AFL on-line library: 

More Information: 

Updated on-line reference 


GfxCircle - draw a circle 
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GfxDrawText 

- draw a text (clipped to rectangle) 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxDrawText( "text", left, top, right, bottom, format = 0 ) 

RETURNS NOTHING 

FUNCTION Formats and draws text in the given rectangie. It formats text by expanding tabs into 
appropriate spaces, aiigning text to the ieft, right, or center of the given rectangie, and 
breaking text into iines that fit within the given rectangie. The type of formatting is specified 
by format argument. When format is not specified the text is aiigned to the top/ieft corner. 

Parameters: 


• "text" - string to be drawn 

• left - x-coordinate of upper ieft corner of the ciipping rectangie 

• top - y-coordinate of upper ieft corner of the ciipping rectangie 

• right - x-coordinate of iower right corner of the ciipping rectangie 

• bottom - y-coordinate of iower right corner of the ciipping rectangie 

• format - specifies the method of formatting the text. It can be any combination of the 
foiiowing vaiues (combine using the bitwise OR operator): 

♦ DT_BOTTOM = 8 - Specifies bottom-justified text. This vaiue must be 
combined with DT_SINGLELINE. 

♦ DT_CENTER = 1 - Centers text horizontaiiy. 

♦ DT_END_ELLIPSIS = 32768 or DT_PATH_ELLIPSIS = 16384 - Repiaces 
part of the given string with eiiipses, if necessary, so that the resuit fits in the 
specified rectangie. You can specify DT END ELLIPSIS to repiace 
characters at the end of the string, or DT_PATH_ELLIPSIS to repiace 
characters in the middie of the string. If the string contains backsiash (\) 
characters, DT PATH ELLIPSIS preserves as much as possibie of the text 
after the iast backsiash. 

♦ DT EXPANDTABS = 64 - Expands tab characters. The defauit number of 
characters per tab is eight. 

♦ DT_LEFT = 0 - Aiigns text fiush-ieft. 

♦ DT_NOCLIP = 256 - Draws without ciipping. DrawText is somewhat faster 
when DT NOCLIP is used. 

♦ DT_NOPREFIX = 2048 - Turns off processing of prefix characters. Normaiiy, 
DrawText interprets the ampersand (&) mnemonic-prefix character as a 
directive to underscore the character that foiiows, and the two-ampersand 
(&&) mnemonic-prefix characters as a directive to print a singie ampersand. 
By specifying DT_NOPREFIX, this processing is turned off. 

♦ DT_RIGHT = 2 - Aiigns text fiush-right. 

♦ DT_SINGLELINE = 32 - Specifies singie iine oniy. Carriage returns and 
iinefeeds do not break the iine. 

♦ DT_TOP = 0 - Specifies top-justified text (singie iine oniy). 

♦ DT_VCENTER = 4 - Specifies verticaiiy centered text (singie iine oniy). 

♦ DT_WORDBREAK = 16 - Specifies word-breaking. Lines are automaticaiiy 
broken between words if a word wouid extend past the edge of the rectangie 
specified by ipRect. A carriage returniinefeed sequence wiii aiso break the 
iine. 


GfxDrawText - draw a text (clipped to rectangle) 
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Note: DT_ constants come from Windows API and are provided here for reference oniy. 

They are not defined in AmiBroker therefore you should use numerical values instead. 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE // formatted text output sample via low-level gfx functions 


CellHeight = 20; 

CellWidth = 100; 

GfxSelectFont ( "Tahoma", CellHeight/2 ); 


function PrintInCell( string, row. Col ) 

{ 

GfxDrawText ( string. Col * CellWidth, row * CellHeight, (Col + 1 ) * 

CellWidth, (row + 1 ) * CellHeight, 0 ); 

} 

PrintInCell( "Open", 0, 0 ); 

PrintInCell( "High", 0, 1 ); 

PrintInCell( "Low", 0, 2 ); 

PrintInCell( "Close", 0, 3 ); 

PrintInCell( "Volume", 0, 4 ); 

GfxSelectPen ( colorBlue ) ; 
for ( i=l; i<10&&i< BarCount; i++ ) 

{ 


PrintInCell( 

StrFormat ( "%g" , 

Of 

i ] 

) , i. 

0 

) ; 

PrintInCell( 

StrFormat ("%g". 

H[ 

i ] 

) , i. 

1 

) ; 

PrintInCell( 

StrFormat ("%g". 

L[ 

i ] 

) , i. 

2 

) ; 

PrintInCell( 

StrFormat ("%g". 

C[ 

i ] 

) , i. 

3 

) ; 

PrintInCell( 

StrFormat ( "%g" , 

V[ 

i ] 

) , i. 

4 

); 

GfxMoveTo ( 0, 

i * CellHeight 

); 





GfxLineTo ( 5 

} 

GfxMoveTo ( 0, 

* CellWidth, i 

* CellHeight 

; 


i * CellHeight 

); 






GfxLineTo ( 5 * CellWidth, i * CellHeight ); 


for ( Col = 1; Col < 6; Col++ ) 

{ 

GfxMoveTo ( Col * CellWidth, 0); 

GfxLineTo ( Col * CellWidth, 10 * CellHeight 

} 


SEE ALSO GfxSetTextColorQ function , GfxTextOutQ function , GfxSetBkColor() function , 
GfxSetBkModeO function 

References: 


The GfxDrawText function is used in the following formulas in AFL on-line library: 
• Basket Trading System T101 


GfxDrawText- draw a text (clipped to rectangle) 
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• BEANS-Summary of Holdings 

• Continuous Contract Rollover 

• GFX ToolTip 

• Heatmap V1 

• Market Breadth Chart-In-Chart 

• Multiple Ribbon Demo 

• Visi-Trade 

More information: 

Updated on-line reference 


GfxDrawText- draw a text (clipped to rectangle) 
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GfxEllipse 
- draw an ellipse 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxElllpse( x1, y1, x2, y2 ) 

RETURNS NOTHING 

FUNCTION Draws an ellipse. The center of the ellipse is the center of the bounding rectangle specified 
by x1, y1, x2, and y2. The ellipse is drawn with the current pen, and its interior is filled with 
the current brush. 

Parameters 


• x1 - x-coordinate of the upper left corner of the bounding rectangle 

• y1 - y-coordinate of the upper left corner of the bounding rectangle 

• x2 - x-coordinate of the lower right corner of the bounding rectangle 

• y2 - y-coordinate of the lower right corner of the bounding rectangle 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxEllipse( 10, 10, 200, 100 ); 

SEE ALSO GfxSelectPenO function , GfxSelectSolidBrush() function 

References: 


The GfxEllipse function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


GfxEllipse - draw an ellipse 
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GfxGetTextWidth Low-level graphics 

- get pixel width of text ^ 


SYNTAX 

GfxGetTextWidthC'text") 

RETURNS 

NUMBER 

FUNCTION 

The function returns pixel width of specified string. NOTE: it is slow because it has to create 
temporary DC and font to measure the text. It takes 40us (microseconds), that is about 40 
times more than other Gfx functions. 

EXAMPLE 

GfxSetZOrder ( 5 ); 

GfxSelectFont ("Tahoma", 30 ); 

GfxSetTextColor ( colorWhite ) ; 
text = "This is a test"; 

GfxTextOut (text, 0, 50); 

GfxSetTextColor ( colorRed ); 

GfxTextOut ("second part in red", GfxGetTextWidth (text), 50 ); 


SEE ALSO GfxTextOutQ function 

References: 

The GfxGetTextWidth function is used in the foilowing formulas in AFL on-line library: 

More Information: 

Updated on-line reference 


GfxGetTextWidth - get pixel width of text 


754 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


GfxGradientRect 

- draw a rectangle with gradient fill 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxGradlentRect( x1, y1, x2, y2, fromcolor, tocolor) 

RETURNS NOTHING 

FUNCTION Draws a rectangle. The interior of the rectangie is fiiied using gradient coior. 
Parameters 


• x1 - x-coordinate of the upper ieft corner of the rectangie 

• y1 - y-coordinate of the upper left corner of the rectangle 

• x2 - x-coordinate of the lower right corner of the rectangle 

• y2 - y-coordinate of the lower right corner of the rectangle 

• fromcolor - the 'upper' color of the gradient fill 

• tocolor - the 'lower' color of the gradient fill 

The rectangle extends up to, but does not include, the right and bottom coordinates. This 
means that the height of the rectangle is y2 - y1 and the width of the rectangle is x2 - x1. 

Both the width and the height of a rectangle must be greater than 2 and less than 32767. 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxGradientRect( 10, 10, 100, 100, colorWhite, colorGreySO ); 

SEE ALSO GfxRoundRectO function , GfxRectangle() function 

References: 


The GfxGradientRect function is used in the following formulas in AFL on-line library: 

• Probability Density & Gaussian Distribution 

• Visi-Trade 


More information: 

Updated on-line reference 


GfxGradientRect - draw a rectangle with gradient fill 
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AmiBroker Formula Language (AFL) 


GfxLineTo 

- draw a line to specified point 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxLlneTo( x, y ) 

RETURNS NOTHING 

FUNCTION Draws a line from the current position up to, but not including, the point specified by x and y. 
The line is drawn with the selected pen. The current position is set to x,y. Parameters 


• X - Specifies the x-coordinate of the end point of the line. 

• y - Specifies the y-coordinate of the end point of the line. 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxMoveTo ( 0, 0 ) ; 

GfxLineTo( 100, 100 ); 

SEE ALSO GfxMoveToO function 

References: 


The GfxLineTo function is used in the following formulas in AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Continuous Contract Rollover 

• Market Breadth Chart-In-Chart 

• Probability Density & Gaussian Distribution 

• Visi-Trade 

• Volume Charts 

More Information: 


Updated on-line reference 


GfxLineTo - draw a line to specified point 
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AmiBroker Formula Language (AFL) 


GfxMoveTo 

- move graphic cursor to new position 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxMoveTo( x, y ) 

RETURNS NOTHING 

FUNCTION Moves the current position to the point specified by x and y. Parameters 

• X - Specifies the x-coordinate of the new position. 

• y - Specifies the y-coordinate of the new position. 


NOTE: This is LOW-LEVEL graphic function. To iearn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxMoveTo( 10, 20 ); 

SEE ALSO 
References: 


The GfxMoveTo function is used in the following formulas in AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Continuous Contract Rollover 

• Market Breadth Chart-In-Chart 

• Probability Density & Gaussian Distribution 

• Visi-Trade 


More Information: 

Updated on-line reference 


GfxMoveTo - move graphic cursor to new position 
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AmiBroker Formula Language (AFL) 


GfxPie 
- draw a pie 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxPle( x1, y1, x2, y2, x3, y3, x4, y4 ) 

RETURNS NOTHING 

FUNCTION Draws a pie-shaped wedge by drawing an eiiipticai arc whose center and two endpoints are 
joined by iines. The center of the arc is the center of the bounding rectangie specified by x1, 
y1, x2, and y2. The starting and ending points of the arc are specified by x3, y3, x4, and y4. 

The arc is drawn with the seiected pen, moving in a counterciockwise direction. Two 
additionai lines are drawn from each endpoint to the arc's center. The pie-shaped area is 
filled with the current brush. If x3 equals x4 and y3 equals y4, the result is an ellipse with a 
single line from the center of the ellipse to the point (x3, y3) or (x4, y4). 

Parameters 


• x1 - x-coordinate of the upper left corner of the bounding rectangle 

• y1 - y-coordinate of the upper left corner of the bounding rectangle 

• x2 - x-coordinate of the lower right corner of the bounding rectangle 

• y2 - y-coordinate of the lower right corner of the bounding rectangle 

• x3 - x-coordinate of the arc's starting point. This point does not have to lie exactly on 
the arc. 

• y3 - y-coordinate of the arc's starting point. This point does not have to lie exactly on 
the arc. 

• x4 - x-coordinate of the arc's ending point. This point does not have to lie exactly on 
the arc. 

• y4 - y-coordinate of the arc's ending point. This point does not have to lie exactly on 
the arc. 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxSelectPen ( colorRed ) ; 

GfxSelectSolidBrush ( colorBlue ) ; 

GfxPie (100,0,200,100,150,0,200,50); 

SEE ALSO GfxSelectPenO function , GfxSelectSolidBrush() function 

References: 


The GfxPie function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


GfxPie - draw a pie 
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AmiBroker Formula Language (AFL) 


GfxPolygon 
- draw a polygon 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxPolygon( x1, y1, x2, y2,...) 

RETURNS NOTHING 

FUNCTION Draws a polygon consisting of two or more points (vertices) connected by iines, using the 
current pen. The system doses the poiygon automaticaiiy, if necessary, by drawing a iine 
from the iast vertex to the first. 

This function takes variabie number of arguments and accepts up to 12 points (24 arguments 
= 12 co-ordinate pairs). The number of arguments must be even as each pair represents 
(x,y) co-ordinates of the vertex. 

The polygon is filled with current brush and outline is painted with current pen. 

Parameters: 


• x1 - X co-ordinate of first point 

• y1 - y co-ordinate of first point 

• x2 - X co-ordinate of second point 

• y2 - y co-ordinate of second point 

• 

• x12 - X co-ordinate of 12th point 

• y12 - y co-ordinate of 12th point 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxSelectPen { colorGreen, 2 ); 

GfxSelectSolidBrush ( colorYellow ); 

GfxPolygon (250,200,200,200,250, 0, 200,50) ; 

SEE ALSO GfxPolylineQ function , GfxSelectPen() function , GfxSelectSolidBrush() function 

References: 


The GfxPolygon function is used in the following formulas in AFL on-line library: 

More Information: 


Updated on-line reference 


GfxPolygon - draw a polygon 
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AmiBroker Formula Language (AFL) 


GfxPolyline 
- draw a polyline 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxPolyllne( x1, y1, x2, y2,...) 

RETURNS NOTHING 

FUNCTION Draws a set of line segments connecting the points specified by arguments (x1 ,y1), (x2,y2), 

... The lines are drawn from the first point through subsequent points using the current pen. 
Unlike the GfxLineTo function, the GfxPolyline function neither uses nor updates the current 
position. 

This function takes variable number of arguments and accepts up to 12 points (24 arguments 
= 12 co-ordinate pairs). The number of arguments must be even as each pair represents 
(x,y) co-ordinates of the point. 

Parameters: 


• x1 - X co-ordinate of first point 

• y1 - y co-ordinate of first point 

• x2 - X co-ordinate of second point 

• y2 - y co-ordinate of second point 

• 

• x12 - X co-ordinate of 12th point 

• y12 - y co-ordinate of 12th point 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxSelectPen { colorGreen, 2 ); 

GfxPolyline (250,200,200,200,250, 0,200,50) ; 

SEE ALSO GfxPolygonO function , GfxSelectPen() function 

References: 


The GfxPolyline function is used in the following formulas in AFL on-line library: 
• Market Profile 

More Information: 


Updated on-line reference 


GfxPolyline - draw a polyline 
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AmiBroker Formula Language (AFL) 


GfxRectangle 
- draw a rectangle 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxRectangle( x1, y1, x2, y2 ) 

RETURNS NOTHING 

FUNCTION Draws a rectangle using the current pen. The interior of the rectangie is fiiied using the 
current brush. 

Parameters 


• x1 - x-coordinate of the upper left corner of the rectangle 

• y1 - y-coordinate of the upper left corner of the rectangle 

• x2 - x-coordinate of the lower right corner of the rectangle 

• y2 - y-coordinate of the lower right corner of the rectangle 

The rectangle extends up to, but does not include, the right and bottom coordinates. This 
means that the height of the rectangle is y2 - y1 and the width of the rectangle is x2 - x1. 

Both the width and the height of a rectangle must be greater than 2 and less than 32767. 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxRectangle( 10,10, 30, 30 ) 

SEE ALSO GfxSelectPenO function , GfxSelectSolidBrush() function 

References: 


The GfxRectangle function is used in the following formulas in AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Continuous Contract Rollover 

• GFX ToolTip 

• Market Breadth Chart-In-Chart 

• Market Profile 

• Volume Charts 

More Information: 


Updated on-line reference 


GfxRectangle - draw a rectangle 
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AmiBroker Formula Language (AFL) 


GfxRoundRect 

- draw a rectangle with rounded corners 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxRoundRect( x1, y1, x2, y2, x3, y3 ) 

RETURNS NOTHING 

FUNCTION Draws a rectangle with rounded corners using the current pen. The interior of the rectangie is 
fiiied using the current brush. 

Parameters 

• x1 - x-coordinate of the upper left corner of the rectangle 

• y1 - y-coordinate of the upper left corner of the rectangle 

• x2 - x-coordinate of the lower right corner of the rectangle 

• y2 - y-coordinate of the lower right corner of the rectangle 

• x3 - the width of the ellipse used to draw the rounded corners 

• y3 - the height of the ellipse used to draw the rounded corners 


The rectangle extends up to, but does not include, the right and bottom coordinates. This 
means that the height of the rectangle is y2 - y1 and the width of the rectangle is x2 - x1. 

Both the width and the height of a rectangle must be greater than 2 and less than 32767. 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxRoundRect( 10, 10, 100, 100, 15, 15 ); 

SEE ALSO GfxRectangleO function , GfxSelectPen() function , GfxSelectSolidBrush() function 

References: 


The GfxRoundRect function is used in the following formulas in AFL on-line library: 

• Bid Vs Ask Dashboard 

• GFX ToolTip 

• Heatmap V1 

• ZLEMA ATR Long Only Trading System 

More information: 


Updated on-line reference 


GfxRoundRect - draw a rectangle with rounded corners 
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AmiBroker Formula Language (AFL) 


GfxSelectFont 
- create / select graphic font 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxSelectFont( "facename", pointsize, weight = fontNormal, italic = False, underline = 
False, orientation = 0 ) 

RETURNS NOTHING 

FUNCTION Initializes a font with the specified characteristics. Then selects the the as current for 
subsequent drawing operations. 

Parameters: 


• "facename" - specifies the typeface name of the font 

• pointsize - specifies point size of the font (fractional numbers are allowed), for 
example 11.5 gives 11.5 point font. 

• weight - specifies the font weight (in inked pixels per 1000). Typical values are: 300 - 
light, 400 - normal, 700 - bold, 800 - ultrabold 

• italic - specifies whether the font is italic 

• underline - specifies whether the font is underlined 

• orientation - specifies the angle (in 0.1-degree units) between the baseline of a 
character and the x-axis. The angle is measured counterclockwise from the x-axis. 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxSelectFont ( "Tahoma" , 20, 700 ); 

GfxSetBkMode (1); 

GfxSetTextColor (colorBrown); 

GfxTextOut ( "Testing graphic capabilites" , 20, 28 ); 

SEE ALSO GfxLineToQ function , GfxMoveTo() function , GfxSelectPen() function , 

GfxSelectSolidBrushO function , GfxSetPixel() function , GfxTextOut() function 

References: 


The GfxSelectFont function is used in the following formulas in AFL on-line library: 

• BEANS-Summary of Holdings 

• Bid Vs Ask Dashboard 

• Continuous Contract Rollover 

• GFX ToolTip 

• Heatmap VI 

• Market Breadth Chart-In-Chart 

• Market Profile 

• Multiple Ribbon Demo 

• Perceptron 

• Point & figure Chart India Securities 

• Probability Density & Gaussian Distribution 

• Visi-Trade 

• Woodie's CCI Panel Full Stats 

• ZLEMA ATR Long Only Trading System 


GfxSelectFont - create / select graphic font 
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AmiBroker Formula Language (AFL) 


More information: 

Updated on-line reference 


GfxSelectFont- create / select graphic font 
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AmiBroker Formula Language (AFL) 


GfxSelectHatchBrush Low-level graphics 

- select hatch style brush ^ 


SYNTAX 

GfxSelectHatchBrush( color, style ) 

RETURNS 

NOTHING 

FUNCTION 

The function seiect hatch brush styie for fiiied areas. 

Supported hatch styies: 

HS HORIZONTAL 0 /* —- 7 

HS_VERTICAL 1 /* ||||| 7 

HS_FDIAGONAL 2 /* W 7 

HS_BDIAGONAL 3 /* Hill 7 

HS_CROSS 4 /* -H-r-r-r-H 7 

HS_DIAGCROSS 5 /* xxxxx 7 

EXAMPLE 

Hatch color is specified by color parameter, hatch background is specified by current 
background color see: GfxSetBkColorQ 

GfxSelectPen ( colorOrange, 4 ); 

GfxSetBkColor ( colorLightGrey ) ; 

GfxSelectHatchBrush ( colorBlue, Param ( "Hatch pattern", 5, 0, 5 ) ) ; 

GfxCircle (100, 100, 20 ) ; 

SEE ALSO 

GfxSetBkColorO function 

References: 



The GfxSelectHatchBrush function is used in the foiiowing formuias in AFL on-iine iibrary: 

More Information: 

Updated on-iine reference 


GfxSelectHatchBrush - select hatch style brush 
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GfxSelectPen 

- create / select graphic pen 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxSelectPen( color, width = 1, peristyle = penSolid ) 

RETURNS NOTHING 

FUNCTION GfxSelectPen initializes (if not already initialized) a pen with the specified style, width, and 
color. Then selects the pen as current for subsequent drawing operations. 

Parameters: 


• color - specifies color for the pen 

• peristyle - specifies the style for the pen. Solid=0, Dash=1, Dot=2, Null=5 (invisible 
pen). Lines of width > 1 can only use solid style. For a list of other possible values, 
see the Microsoft docs on CreatePen Windows API function. 

• width - specifies the width of the pen. If this value is 0, the width in device units is 
always 1 pixel, regardless of the mapping mode (this is useful for drawing hairline 
lines on printer outputs). 

More info on pens in Windows GDI: http://msdn2.microsoft.com/en-us/library/ms535467 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 

please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxSelectPen { colorGreen, 2 ); 

GfxSelectSolidBrush { colorYellow ); 

GfxPolygon (250,200,200,200,250, 0, 200,50) ; 

SEE ALSO GfxLineToO function , GfxMoveTo() function , GfxSetPixel() function , GfxTextOut() function 

References: 

The GfxSelectPen function is used in the following formulas in AFL on-line library: 


• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Bid Vs Ask Dashboard 

• Continuous Contract Rollover 

• GFX ToolTip 

• Heatmap V1 

• Market Breadth Chart-In-Chart 

• Market Profile 

• Probability Density & Gaussian Distribution 

• Visi-Trade 

• Volume Charts 

• Woodie's CCI Panel Full Stats 

• ZLEMA ATR Long Only Trading System 

More Information: 


Updated on-line reference 


GfxSelectPen - create / select graphic pen 
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GfxSelectPen - create / select graphic pen 
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GfxSelectSolidBrush 
- create / select graphic brush 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxSelectSolldBrush( color) 

RETURNS NOTHING 

FUNCTION GfxSelectSolidBrush initializes a brush with a specified solid color. Then selects the brush as 
current for subsequent drawing operations. 

Parameters: 


• color - specifies color for the brush 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxSelectPen { colorGreen, 2 ); 

GfxSelectSolidBrush ( colorYellow ); 

GfxPolygon (250,200,200,200,250, 0, 200, 50) ; 

SEE ALSO GfxLineToO function , GfxMoveTo() function , GfxSelectPen() function , GfxSetPixel() 
function , GfxTextOutQ function 

References: 


The GfxSelectSolidBrush function is used in the following formulas in AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Bid Vs Ask Dashboard 

• Continuous Contract Rollover 

• GFX ToolTip 

• Heatmap V1 

• Market Breadth Chart-In-Chart 

• Market Profile 

• Volume Charts 

• Woodie's CCI Panel Full Stats 

• ZLEMA ATR Long Only Trading System 

More Information: 


Updated on-line reference 


GfxSelectSolidBrush - create / select graphic brush 


768 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


GfxSetBkColor 

- set graphic background color 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxSetBkColor( color) 

RETURNS NOTHING 

FUNCTION Sets the current background color to the specified coior. If the background mode is OPAQUE 
(see GfxSetBkMode), the system uses the background coior to fiii the gaps in styied iines, 
the gaps between hatched iines in brushes, and the background in character ceiis. 

Parameters: 


• coior - specifies the new background color 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic 
functions please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxSetBkColor( ColorRGB( 10, 20, 30 )); 

SEE ALSO GfxSelectFontQ function , GfxSetTextColorQ function 

References: 


The GfxSetBkColor function is used in the following formulas in AFL on-line library: 

• Basket Trading System T101 

• GFX ToolTip 

• Point & figure Chart India Securities 
More Information: 

Updated on-line reference 


GfxSetBkColor - set graphic background color 
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AmiBroker Formula Language (AFL) 


GfxSetBkMode 

- set graphic background mode 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxSetBkMode( bkmode) 

RETURNS NOTHING 

FUNCTION Sets the background mode. The background mode defines whether the system removes 

existing background coiors on the drawing surface before drawing text, hatched brushes, or 
any pen styie that is not a soiid iine. 

Parameters: 


• bkmode - Specifies the mode to be set. This parameter can be either of the foliowing 
values: 

OPAQUE = 2 - Background is filled with the current background color before the text, 
hatched brush, or pen is drawn. This is the default background mode. 
TRANSPARENT = 1 - Background is not changed before drawing 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic 
functions please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxSetBkMode( 1 ); // set transparent mode 

SEE ALSO GfxSetTextAlignO function , GfxSetTextColorQ function , GfxTextOut() function , 
GfxSelectPenO function 

References: 


The GfxSetBkMode function is used in the following formulas in AFL on-line library: 

• BEANS-Summary of Holdings 

• Bid Vs Ask Dashboard 

• Continuous Contract Rollover 

• GFX ToolTip 

• Heatmap V1 

• Market Profile 

• Perceptron 

• Probability Density & Gaussian Distribution 

• Visi-Trade 

• Woodie's CCI Panel Full Stats 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


GfxSetBkMode - set graphic background mode 
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GfxSetCoordsMode 

- set low-level graphics co-ordinate mode 

SYNTAX GfxSetCoordsMode( mode) 

RETURNS NOTHING 

FUNCTION The function allows to switch co-ordinate system for low-level gfx functions from sceen pixel 
(mode = 0) - the default, to bar / price mode (mode = 1 ) where X is expressed in bar index 
and Y is expressed in price. This new mode allows way easier overlays on top of existing 
charts without need to do conversion between bars/price pixels and without any extra refresh 
normally required in old versions when Y scale changed. The function can be called to switch 
back and forth from pixel -> bar/price mode and vice versa a number of times allowing to mix 
different modes in the same chart. When co-ordinate mode 1 is selected (bar/price), 
co-ordinates can be fractional. For example if x is 2.5 it means half way between bar 2 and 3. 

EXAMPLE // The sample shows how using GfxSetCoordsMode( 1 ) 

// results in 

// a) easier coding of overlay charts that plot on top of built-in 
charts (no need to convert from bar/price to pixels) 

// b) perfect matching between built-in Plot() and Gfx positioning 
Plot ( C, "Price", colorDefault, styleLine ); 

GfxSetOverlayMode ( 1 ); 

GfxSetCoordsMode ( 1 ); // bar/price mode (instead of pixel) 

GfxSelectSolidBrush ( colorRed ); 

GfxSelectPen ( colorRed ); 

boxheight = 0.01 * ( HighestVisibleValue ( C ) - LowestVisibleValue ( 

C ) ) ; 

bi = BarIndexO; 

start = FirstVisibleValue ( bi ); 
end = LastVisibleValue ( bi ) ; 

for ( i = start; i <= end; i++ ) 

{ 

Cl = Close [ i ]; 

Op = Open [ i ]; 

Color = IIf( Cl > Op, colorGreen, colorRed ); 

GfxSelectPen ( Color ); 

GfxSelectSolidBrush ( Color ); 

bodyup = Max ( Op, Cl ); 
bodydn = Min ( Op, Cl ); 

GfxEllipse ( i - 0.4, bodyup, i + 0.4, bodydn ); 

GfxMoveTo ( i, H[ i ] ); 
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GfxLineTo ( i, bodyup ); 

GfxMoveTo ( i, bodydn ) ; 

GfxLineTo ( i, L[ i ] ); 

} 

SEE ALSO 
References: 

The GfxSetCoordsMode function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-iine reference 


GfxSetCoordsMode- set low-level graphics co-ordinate mode 
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GfxSetOverlayMode 
- set low-level graphic overlay mode 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxSetOverlayMode( mode = 0) 


RETURNS NOTHING 


FUNCTION Sets overlay mode for low-level graphics. 


Parameters: 

• mode - desired overiay mode. Possibie vaiues are: 

0 - (defauit) iow-level graphic is overlaid on top of charts 

1 - charts are overlaid on top of low-level graphics 

2 - only low-level graphics is displayed (no charts, no grids, etc) 

To learn more about low level graphics please read Tutorial: Using low-level graphics 


EXAMPLE GfxSetOverlayMode( 2 ); // don't display charts nor grids 

SEE ALSO GfxArcO function , GfxChord() function , GfxCircle() function , GfxDrawTextQ function , 


GfxEllipseO function , GfxGradientRect() function , GfxLlneToQ function , GfxMoveTo() 
function , GfxPieO function , GfxPolygon() function , GfxPolyline() function , GfxRectangle() 
function , GfxRoundRectO function [[331:Gfx 


References: 

The GfxSetOverlayMode function is used in the following formulas in AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• GFX ToolTip 

• Market Breadth Chart-In-Chart 

• Market Profile 

• Visi-Trade 

• Woodie's CCI Panel Full Stats 

• ZLEMA ATR Long Only Trading System 

More Information: 

Updated on-line reference 


GfxSetOverlayMode - set low-level graphic overlay mode 
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GfxSetPixel 

- set pixel at specified position to specified color 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxSetPlxel( x, y, color) 

RETURNS NOTHING 

FUNCTION Sets the pixel at the specified x, y coordinates to the specified color. The point must be in the 

visible part drawing surface (otherwise it won't be painted). Parameters 

• X - Specifies the x-coordinate of the point. 

• y - Specifies the y-coordinate of the point. 

• color - specifies the color to be used to paint the point 


NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxSetPixel ( 20, 20 ) ; 

SEE ALSO GfxLineToO function , GfxMoveTo() function 

References: 


The GfxSetPixel function is used in the following formulas in AFL on-line library: 

More Information: 

Updated on-line reference 


GfxSetPixel - set pixel at specified position to specified color 
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GfxSetText Align 
- set text alignment 


Low-level graphics 

(AFL 3.0) 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 
SEE ALSO 


GfxSetTextAllgn( align) 

NOTHING 

Sets the text-alignment flags. 

The GfxTextOut function uses these flags when positioning a string of text on a display or 
device. The flags specify the relationship between a specific point and a rectangle that 
bounds the text. The coordinates of this point are passed as parameters to the TextOut 
member function. The rectangle that bounds the text is formed by the adjacent character 
cells in the text string. 

Parameters: 

• align - combination (binary-OR) of one or more the following flags: 

X-direction alignment: 

♦ TA_CENTER = 6 - Aligns the point with the horizontal center of the bounding 
rectangle. 

♦ TA_LEFT = 0 - Aligns the point with the left side of the bounding rectangle. 
This is the default setting. 

♦ TA_RIGHT = 2 - Aligns the point with the right side of the bounding 
rectangle. 

Y-direction alignment 

♦ TA_BASELINE = 24 - Aligns the point with the base line of the chosen font. 

♦ TA_BOTTOM = 8 - Aligns the point with the bottom of the bounding 
rectangle. 

♦ TA_TOP = 0 - Aligns the point with the top of the bounding rectangle. This is 
the default setting. 

flags that determine whether the current position is updated when text is written: 

♦ TA_NOUPDATECP = 0 - Does not update the current position after each call 
to a text-output function. This is the default setting. 

♦ TA_UPDATECP = 1 - Updates the current x-position after each call to a 
text-output function. The new position is at the right side of the bounding 
rectangle for the text. When this flag is set, the coordinates specified in calls 
to the GfxTextOut member function are ignored 

Note: TA_ constants come from Windows API, they are given for reference only they are not 
predefined in AmiBroker, so you need to use numerical values. 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

GfxSetTextAlign( 6 | 24 ); // center and baseline alignment 

GfxSetTextColorQ function , GfxTextOutQ function , GfxSetBkColor() function , 
GfxSetBkModeO function , GfxSelectFont() function 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 
SEE ALSO 


GfxSetText Align - set text alignment 
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References: 

The GfxSetTextAlign function is used in the foiiowing formuias in AFL on-iine iibrary: 

• GFX ToolTip 

• Market Profile 

• Probability Density & Gaussian Distribution 

• Woodie's CCI Panel Full Stats 

More information: 

Updated on-line reference 


GfxSetTextAlign- set text alignment 
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GfxSetTextColor 
- set graphic text color 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxSetTextColor( color) 

RETURNS NOTHING 

FUNCTION Sets the text color to the specified coior. AmiBroker wiii use this text coior when writing text 
to this window using GfxTextOut or GfxDrawText. 

The background coior for a character is specified by the GfxSetBkCoior and GfxSetBkMode 
member functions. 


Parameters: 

• coior - Specifies the color of the text 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxSetTextColor( colorRed); 

GfxSetTextColor( ColorRGB( 100, 200, 100 )); 

SEE ALSO GfxTextOutO function , GfxDrawText() function , GfxSelectFont() function , GfxSetBkColor() 
function , GfxSetBkModeO function 

References: 


The GfxSetTextColor function is used in the following formulas in AFL on-line library: 

• Basket Trading System T101 

• BEANS-Summary of Holdings 

• Bid Vs Ask Dashboard 

• Continuous Contract Rollover 

• GFX ToolTip 

• Heatmap VI 

• Market Breadth Chart-In-Chart 

• Market Profile 

• Multiple Ribbon Demo 

• Point & figure Chart India Securities 

• Probability Density & Gaussian Distribution 

• Visi-Trade 

• Woodie's CCI Panel Full Stats 

• ZLEMA ATR Long Only Trading System 

More Information: 


Updated on-line reference 


GfxSetTextColor - set graphic text color 
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GfxSetZOrder 

- set current low-level graphic Z-order layer 


Low-level graphics 

(AFL 2.80) 


SYNTAX GfxSetZOrder( layer) 

RETURNS NOTHING 

FUNCTION Sets current z-order layer to be used for subsequent low level Gfx* calls 

EXAMPLE Plot ( C, "Price", colorDefault ); 

GraphGridZOrder = 1 ; 


GfxSetZOrder (0) ; 

GfxSelectSolidBrush ( colorGreen ) ; 
GfxCircle ( 100, 100, 100 ); 


GfxSetZOrder (-1 ); 
GfxSelectSolidBrush ( colorRed ); 
GfxCircle ( 150, 150, 100 ) ; 


GfxSetZOrder (-2 ); 

GfxSelectSolidBrush ( colorBlue ) ; 
GfxCircle ( 180, 180, 100 ) ; 


SEE ALSO 
References: 


The GfxSetZOrder function is used in the foliowing formulas in AFL on-line library: 

More Information: 


Updated on-line reference 


GfxSetZOrder - set current low-level graphic Z-order layer 
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GfxTextOut 

- writes text at the specified iocation 


Low-level graphics 

(AFL 3.0) 


SYNTAX GfxTextOut( "text", x, y ) 

RETURNS NOTHING 

FUNCTION Writes a character string at the specified iocation using the currentiy seiected font. 
Parameters: 


• "text" - Specifies the character string to be drawn 

• X - Specifies the x-coordinate of the starting point of the text 

• y - Specifies the y-coordinate of the starting point of the text 

Character origins are at the upper-ieft corner of the character ceii. By defauit, the current 
position is not used or updated by the function. 

The font used can be set using GfxSeiectFont() function. Text coior can be set using 
GfxSetTextCoiorQ function. 

If a formula needs to update the current position when it calls GfxTextOut, the formula can 
call the GfxSetTextAlign function with flags set to 1 (TA_UPDATECP Windows flag). When 
this flag is set, GfxTextOut function ignores the x and y parameters on subsequent calls to 
GfxTextOut, using the current position instead. 

The output of this function is NOT clipped. If you want clip text to user-defined rectangle, use 
GfxDrawTextO function instead. 

NOTE: This is LOW-LEVEL graphic function. To learn more about low-level graphic functions 
please read TUTORIAL: Using low-level graphics. 

EXAMPLE GfxSelectFont ( "Times New Roman", 16, 700, True ); 

GfxTextOut ( "Percent of shares held by:", 10 , 10 ); 

SEE ALSO GfxLineToO function , GfxMoveTo() function , GfxSetPixel() function 

References: 


The GfxTextOut function is used in the following formulas in AFL on-line library: 


• Bid Vs Ask Dashboard 

• GFX ToolTip 

• Market Profile 

• Perceptron 

• Point & figure Chart India Securities 

• Probability Density & Gaussian Distribution 

• Woodie's CCI Panel Full Stats 

• ZLEMA ATR Long Only Trading System 


GfxTextOut - writes text at the specified location 
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More information: 

Updated on-line reference 


GfxTextOut- writes text at the specified location 
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GicsID 

- get GIGS category information 


Information / Categories 

(AFL 3.40) 


SYNTAX GicslD( mode) 

RETURNS STRING 

FUNCTION The function gets information about current symboi GIGS category. 


• mode = 0 - returns string containing GIGS code aione (such as " 15103020") 

• mode = 1 - returns string containing GIGS category name (such as "Paper 
Packaging") 

• mode = 2 - returns string containing both code and name (such as "15103020 Paper 
Packaging") 

EXAMPLE printf ("GICS(0) = " + GicsID ( 0)); 

printf ("GIGS(1) = " + GicsID ( 1)); 
printf ("GICS(2) = " + GicsID ( 2 )); 


for ( i = 10; i < 90; i+= 1 ) 

{ 

gics_code = StrFormat ( "%02.Of" , i ); 

printf ("In Gics '"+ gics_code + "' = %g\n", InGics ( gics_code ) ); 

} 


SEE ALSO 
References: 


InGIGSO function , INDUSTRYIDQ function , GROUPIDQ function , MARKETIDQ function , 
SEGTORIDO function 


The GicsID function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-iine reference 


GicsID - get GICS category information 
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GroupID 

- get group ID/name 


Information / Categories 

(AFL 1.8) 


SYNTAX GrouplD( mode = 0 ) 
RETURNS NUMBER/STRING 


FUNCTION Retrieves current stock group ID/name When mode = 0 (the default value ) this function 
returns numerical group ID (consecutive group number) 

When mode = 1 this function returns name of the group. 

EXAMPLE Filter = GroupIDQ == 7 OR GroupIDQ == 9; 

AddTextColumn( GrouplD( 1 ), "Group name"); 

SEE ALSO 
References: 


The GroupID function is used in the following formulas in AFL on-line library: 
More information: 

Updated on-line reference 


GroupID - get group ID/name 
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Lowest/Highest 


HHV 

- highest high vaiue 


SYNTAX hhv( ARRAY, periods ) 
RETURNS ARRAY 


FUNCTION Calculates the highest value In the ARRAY over the preceding periods {periods Includes the 
current day). HHV accepts periods parameter that can be constant as well as time-variant 
(array). 

EXAMPLE The formula "hhv( close, 4)" returns the highest closing price over the preceding four periods; 
"hhv( high, 8)" returns the highest high price over the preceding eight periods. 

SEE ALSO 
References: 


The HHV function Is used In the following formulas In AFL on-line library: 

• Pivots And Prices And Swing Volume 

• % B of Bollinger Bands With Adaptive Zones 

• 10-20 Indicator 

• 30 Week HI Indicator - Calculate 

• 52 Week New High-New Low Index 

• Adaptave Zones 0/B & 0/S Oscillator 

• Adaptive Price Channel 

• Advanced MA system 

• AFL Example 

• AFL Example - Enhanced 

• Against all odds 

• AJDX system 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• An n bar Reversal Indicator 

• Another Fib Level 

• Aroon 

• AR_Predlctlon.afl 

• ATR Study 

• Auto Trader Basic Flow 

• Auto-Optimizatlon Framework 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Awsome Oscllator 

• babaloo chapora 

• Brian Wild 

• Bull Fear / Bear Fear 

• Bullish Percent Index 2 files combined 

• Bullish Percent Index 2004 

• CAMSLIM Cup and Handle Pattern AFL 

• Candle Stick Demo 


HHV - highest high value 
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• Candlestick Commentary 

• Candlestick Commentary Modified 

• Candlestick Commentary-modified 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI(20) Divergence Indicator 

• CCT Kaleidoscope 

• CCT StochasticRSI 

• Chaikin Volume Accumulation 

• Chandelier Exit 

• Chandelier Exit or Advanced Trailing Stop 

• Channel/S&R and trendlines 

• Compare Sectors against Tickers 

• Congestions detection 

• Continuous Contract Rollover 

• CVR-severe filter 

• Dahl Oscillator modified 

• Daily High Low in Advance 

• Dave Landry PullBack Scan 

• Dave Landry Pullbacks 

• Demand Index 

• Demand Index 

• Dinapoli Perferred Stochastic 

• Divergences 

• Donchian Channel 

• Double Smoothed Stochastic from W.Bressert 

• Double top detection 

• DT Oscillator 

• Ed Seykota's TSP: Support and Resistance 

• Ehlers Fisher Transform 

• ekeko price chart 

• Elder safe Zone Long -i- short 

• Elder Triple Screen Trading System 

• Elder's SafeZone Stop 

• ElderSafeZoneStopLong 

• FastStochK FullStochK-D 

• Fisher Centre of Gravity 

• Fisher Cyber Cycle 

• Fisher Oscillator 

• Fisher Relative Vigour Index 

• Fre 

• Frequency distribution of returns 

• Fund Screener 

• Gann level plotter 

• Gann Swing chart v41212 

• Gordon Rose 

• Head & Shoulders Pattern 

• Hilbert Sine Wave Support & Resistance 

• Ichimoku Chart 

• Ichimoku charts 

• Ichimoku Kinko Hyo 

• ICHIMOKU SIGNAL TRADER 


HHV - highest high value 
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• Ichimoku with plot mofified to use cloud function 

• IchimokuBrianVioreIRO 

• IFT of RSI - Multiple TimeFrames 

• Improved NH-NH scan / indicator 

• Index of 30 Wk Highs Vs Lows 

• Inter-market Yield Linear Regression Divergence 

• Intraday Strength 

• JEEVAN'S SRI CHAKRA 

• Kagi Chart 

• Larry William's Volatility Channels 

• Linear Regression Line & Bands 

• MACD commentary 

• MACD indicator display 

• Meu Sistema de Trading - versao 1.0 

• mitalpradip 

• Modified Head & Shoulder Pattern 

• Monthly bar chart 

• MS Darvas Box with Exploration 

• Multicycle 1.0 

• Multiple Ribbon Demo 

• Murrey Math Price Lines 

• N-period candlesticks (time compression) 

• nikhil 

• Non-repaitning Zigzag line 

• OBV with Linear Regression 

• P&F Chart - High/Low prices Sept2003 

• P&F chart with range box sizes 

• Pattern - Rectangle Base Breakout on High Vol 

• Pattern_-_Rectangle_Base_Breakout_on_High_Vol 2 

• Perceptron 

• Peterson 

• PF Chart - Close - April 2004 

• Pivot Finder 

• Pivots And Prices 

• Point & figure Chart India Securities 

• prakash 

• Prashanth 

• Price with Woodies Pivots 

• Probability Density & Gaussian Distribution 

• PVT Trend Decider 

• Rainbow Oscillator 

• Rea Time Daily Price Levels 

• Regression Analysis Line 

• Relative Strength Index 

• RSI Double-Bottom 

• RSI Pointer 

• RSIS 

• RUTVOL timing signal with BB Scoring routine 

• Sainath Sidgiddi 

• Scan New High and New Low 

• shailu lunia 

• Sony 


HHV - highest high value 
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• Steve Woods' Cum. Vol. Float + Cum. Vol. Channels 

• Steve Woods' Cumulative Vol. Percentage Indicator 

• Stochastic %J - KDJ 

• Stochastic Centre of Gravity 

• Stochastic Cyber Cycle 

• Stochastic Divergence, negative 

• Stochastic Divergences, PDI, NDI 

• Stochastic Fast%K and Full 

• Stochastic OBV and Price Filter 

• Stochastic Relative Vigour Index 

• Stochastic RSI 

• Stop-loss Indicator bands 

• Stops Implementation In AFS 

• Stress with SuperSmoother 

• Sun&Cloud 

• Support and Resistance 

• Support Resistance levels 

• TD Moving Average I 

• TD sequential 

• TD Sequential 

• The Stochastic CCI 

• Three Day Balance Point 

• Tracking Error 

• Tracking Error 

• Trailing Stop Loss 

• Trend Exploration: Count Number of New Highs 

• Trend Following System 

• Trend Trigger Factor 

• Triangle exploration using P&F Chart 

• Triangle search 

• Triangle Search Extended 

• Triangular Moving Average new 

• Trigonometric Fit - TrIgFIt with AR for cos / sin 

• ValueChart 

• Vertical Horizontal Filter 

• Vertical Horizontal Filter (VHF) 

• Volatility System 

• Weekly chart 

• Weinberg's The Range Indicator 

• William's Alligator System II 

• Woodle's CCI Panel Basic 

• Woodle's CCI Panel Full Stats 

• Woodle's Price Panel With Woodle's Pivots 

• ZIg Zag 

• ZLEMA ATR Long Only Trading System 
More information: 

Updated on-line reference 


HHV- highest high value 
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HHVBars Lowest/Highest 

- bars since highest high 


SYNTAX HHVBars( ARRAY, periods ) 
RETURNS ARRAY 


FUNCTION Calculates the number of periods that have passed since the ARRAY reached Its periods 
period peak. HHVBars accepts periods parameter that can be constant as well as 
time-variant (array). 

EXAMPLE The formula "hhvbars( close, 30 )" returns the number of periods that have passed since the 
closing price reached Its 30-perlod peak. 

SEE ALSO 

References: 


The HHVBars function Is used In the following formulas In AFL on-line library: 


• Advanced MA system 

• Aroon Indicators 

• Aroon The Advisor 

• babaloo chapora 

• CAMSLIM Cup and Handle Pattern AFL 

• CCI(20) Divergence Indicator 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Divergences 

• ekeko price chart 

• Fre 

• Fund Screener 

• Gordon Rose 

• Pivot Finder 

• shallu lunia 

• Stochastic Divergence, negative 

• Stochastic Divergences, PDI, NDI 

• Triangle search 

• Triangle Search Extended 

• VIvek Jain 


More information: 

Updated on-line reference 


HHVBars - bars since highest high 
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Highest Lowest/Highest 

- highest vaiue 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


Highest( ARRAY) 

ARRAY 

Calculates the highest value In the ARRAY since the first day/bar present In the database. 

The formula hlghest( mfl(14)) returns the highest Money Flow Index value; highest ( close ) 
returns the highest closing price. 

HHV() function , LOWESTQ function , LLV() function 


The Highest function Is used In the following formulas In AFL on-line library: 

• Alpha and Beta and R_Squared Indicator 

• AR_Predlctlon.afl 

• Auto-Optimizatlon Framework 

• Automatic Trend-line 

• babaloo chapora 

• Candle Stick Analysis 

• Candle Stick Demo 

• CVR-severe filter 

• Double top detection 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Gordon Rose 

• Intraday Volume EMA 

• Market Profile 

• nth (1 - 8 ) Order Polynomial Fit 

• Perceptron 

• Pivot Finder 

• shallu lunia 

• Triangle exploration using P&F Chart 

• Trigonometric Fit - TrIgFIt with AR for cos / sin 

More information: 


Updated on-line reference 


Highest - highest value 
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HighestBars Lowest/Highest 

- bars since highest vaiue 


SYNTAX 

HighestBars( ARRAY) 

RETURNS 

ARRAY 

FUNCTiON 

Calculates the number of periods that have passed since the ARRAYS highest value. 

EXAMPLE 

The formula "highestbars( close )" returns the number of periods that have passed since the 
closing price reached its highest peak. 


SEE ALSO 
References: 

The HighestBars function is used in the foliowing formulas in AFL on-line library: 

• AR_Prediction.afl 

• Trigonometric Fit - TrigFit with AR for cos / sin 
More information: 

Updated on-line reference 


HighestBars - bars since highest value 
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HighestSince 

- highest value since condition met 


Lowest/Highest 

(AFL 1.4) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 


HighestSince( EXPRESSION, ARRAY, Nth=^} 

ARRAY 

Returns the highest ARRAY value since EXPRESSION was true on the Nth most recent 
occurrence. 

highestsince( Cross( macd(), 0 ), Close, 1 ) returns the highest close price since macd() has 
crossed above zero. 


SEE ALSO 
References: 


The HighestSince function is used in the following formulas in AFL on-line library: 

• AJDX system 

• Gann Swing Chart 

• Gann Swing Charts in 3 modes with text 

• Inverted Plotted Volume Overlay Indicator 

• Last Five Trades Result Dashboard - AFL code 

• Market Profile 

• MO_CrashZone 

• RSI of Weekly Price Array 

• Stochastic of Weekly Price Array 

• Time Frame Weekly Bars 

• Visible Min and Max Value Demo 

• Visualization of stoploses and profit in chart 

• Williams Alligator system 

More Information: 


Updated on-line reference 


HighestSince - highest value since condition met 
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HighestSinceBars 

- bars since highest vaiue since condition met 


Lowest/Highest 

(AFL 1.4) 


SYNTAX HighestSinceBars( EXPRESSION, ARRAY, Nth=^} 

RETURNS ARRAY 

FUNCTION Returns the number of bars that have passed since highest ARRAY vaiue since 
EXPRESSION was true on the Nth most recent occurrence. 


EXAMPLE highestsincebars( Cross( macd(), 0 ), Ciose, 1 ) returns the number of bars passed since the 
highest ciose price was detected from the time when macd() has crossed above zero. 


SEE ALSO 
References: 


The HighestSinceBars function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-iine reference 


HighestSinceBars - bars since highest value since condition met 
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HighestVisibleValue 

- get the highest value within visible chart area 


Indicators 

(AFL 3.30) 


SYNTAX HighestVisibleValue( array) 

RETURNS NUMBER 

FUNCTION The function calculates single value (not array) representing highest value of given array 
within VISIBLE range (on chart). 


Should be applied only in indicators as only indicators have concept of "visible" bars. The 
function will return Null value if no visible bars are present. The function is equivalent to the 
following coding: 


function HighestVisibleValueEquivalent( array ) 

{ 

bv = Status ( "barvisible" ); 

Hh = -le8; 

for ( i = 0; i < BarCount; i++ ) 

{ 

if ( bv[ i ] AND array[ i ] > Hh ) Hh = array[ i ]; 


return hh; 

} 


EXAMPLE 

SEE ALSO LowestVisibleValueO function 

References: 


The HighestVisibleValue function is used in the following formulas in AFL on-line library: 

• Fibonacci Calculations & Speed Resistance 

• Fre 


More information: 

Updated on-line reference 


HighestVisibleValue - get the highest value within visible chart area 
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HMA 

- Hull Moving Average 


Moving averages, summation 

(AFL 3.40) 


SYNTAX HMA( array, range ) 

RETURNS ARRAY 

FUNCTiON Implements Hull Moving Average. It is functionaiiy equivaient to the foiiowing code: 


function HMA_AFL( array, period ) 


fast = 

WMA( 

array. 

period / 2 ); 


slow = 

WMA( 

array. 

period ); 


return 

WMA( 

2 * fast - slow, sqrt ( period ) 

); 


EXAMPLE 

SEE ALSO MA() function , WMA() function 

References: 


The HMA function is used in the foliowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 


HMA - Hull Moving Average 
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Trading system toolbox 


Hold 

- hold the alert signal 


SYNTAX 

Hold( EXPRESSION, periods) 

RETURNS 

ARRAY 

FUNCTION 

Holds a "true" result of EXPRESSION for the specified number of periods. This true result is 
held true over the number of periods specified even if a "false" result is generated. 

EXAMPLE 

hold( cross(rsi(14),70),5) 

SEE ALSO 


References: 



The Hold function is used in the foiiowing formuias in AFL on-line library: 

• Peterson 

• TD sequential 

• Williams Alligator system 

More information: 

Updated on-line reference 


Hold - hold the alert signal 
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Hour 

- get current bar's hour 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


HourQ 

ARRAY 

Retrieves current bar's hour 
Hour()*10000 + MinuteO * 100 + Second() 
SecondO, Minute(), TimeNum() MilliSec() function 


The Hour function is used in the foliowing formulas in AFL on-line library: 

• Buyer Seller Force 

• Export EOD or Intraday to .csv file 

• Export Intraday Data 

• Luna Phase 


More information: 


Updated on-line reference 


Date/Time 

(AFL 2.0) 


Hour - get current bar's hour 
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IcbID 

- get ICB category information 


Information / Categories 

(AFL 3.60) 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


SEE ALSO 
References: 


lcblD( mode) 

STRING 

The function gets information about current symboi ICB category. 

• mode = 0 - returns string containing ICB code alone (such as "9530") 

• mode = 1 - returns string containing ICB category name (such as "Software & 
Computer Services") 

• mode = 2 - returns string containing both code and name (such as "9530 Software & 
Computer Services") 


printf ( 

"ICB (0) 

= " + IcbID ( 0 ) 

) ; 

printf ( 

"ICB(1) 

= " + IcbID ( 1 ) 

) ; 

printf ( 

"ICB (2) 

= " + IcbID ( 2 ) 

); 

for ( i = 

= 10; i 

< 90; i+= 1 ) 



{ 


ICB_code = StrFormat ( "%02.Of" , i ); 

printfC'In ICB '"+ ICB_code + "' = %gn", Inlcb( ICB_code ) ); 


} 


lnlCB() function 


The IcbID function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


IcbID - get ICB category information 
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Trading system toolbox 


Ilf 

- immediate IF function 


SYNTAX 

llf( EXPRESSION, TRUE_PART, FALSE_PART ) 

RETURNS 

ARRAY 

FUNCTION 

"Immediate-IF" - a conditional function that returns the value of the second parameter 
(TRUE_PART) if the conditional expression defined by the first parameter (EXPRESSION) is 
true; othen/vise, the value of third parameter is returned (FALSE_PART). Please note that IIF 
is a function - so the result of evaluation is returned by that function and should be assigned 
to some variable. Ilf always evaluates both TRUE_PART and FALSE_PART, even though it 
returns only one of them. Because of this, you should watch for undesirable side effects. The 
following example shows one common error made with IIF function: IIF( condition, result = 7, 
result = 9 ); // THIS IS WRONG Correct usage is: result = IIF( condition, 7, 9 ); /* 7 or 9 is 
*returned* and assigned to a variable depending on condition 7 

When working on arrays, lif function evaluates all bars, condition is checked on each bar and 
returned value for given bar is choosen appropriately on bar by bar basis. The following code 
shows how array operation of lif is implemented internally. Take a look also at Understanding 
AFL chapter of the manual. 

function IIF_AFL( condition, inputA, inputB ) 

{ 

result = Null; 

for ( bar = 0; bar < BarCount; bar++ ) 

{ 

if ( condition[ bar ] ) 

result[ bar ] = InputA [ bar ]; 

else 

result [ bar ] = InputB [ bar ]; 

} 

return result; 

} 

EXAMPLE 

// The formula below 

// will assign positive Volume values to the result variable on days 
when 

// MACD was below its Signal line, AND negative Volume values on 

theother 
// days. 

result = IIf( MACD () < Signal (), Voliime, -Volvime ); 

// The formula below 

// will assign colorRed to the dynamic_color variable on days when 
// Close < Open and color Green otherwise 


Ilf - immediate IF function 
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dynamic_color 
Plot ( Volvime, 
styleThick ); 


= Ilf ( Close < Open, colorRed, 

"Color volume", dynamic_color, 


colorGreen ); 
styleHistogram 


SEE ALSO 
Comments: 


Tomasz Janeczko 

tj --at-- 

amibroker.com 

2003-06-16 

03:04:48 


IIF can be re-implemented using new if-else flow control statements. The code below 
shows this and explains what IIF in fact does internally. 

function _IIF( ConditionArray, TrueArray, FalseArray ) 

{ 

for( I = 0; i < BarCount; i-n-) 

{ 

if( ConditionArray[ i ]) 

{ 

result[ i ] = TrueArray[ i ]; 

} 

else 


{ 

result[ i ] = FalseArray[ i ]; 

} 

} 

} 


Tomasz Janeczko 


If you want to operate on STRINGS use WritelF function: 


tj -at- 


amibroker.com result = WritelF( condition, "Text 1", "Text 2"); 

2003-07-28 

09:24:10 (note that this function returns single string, depending on 'selected value' of condition). 


References: 


The Ilf function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• % B of Bollinger Bands With Adaptive Zones 

• 2 Timeframes Candlestick Bar Chart 

• 3 Price Break 

• 3TF Candlestick Bar Chart 

• AC-r acceleration 

• accum/dist mov avg crossover SAR 

• Adaptave Zones 0/B & 0/S Oscillator 

• Adaptive Centre of Gravity 

• Adaptive Cyber Cycle 

• Adaptive Relative Vigour Index 

• Advanced MA system 

• Advanced Trend Lines with S & R 

• Advisory NRx price chart display. 

• ADX Indicator - Colored 

• AFL-Excel 

• AFL_Glossary_Converter 


Ilf- immediate IF function 
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• Against all odds 

• Alert Output As Quick Rewiev 

• ALJEHANI 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• Analytic RSI formula 

• Andrews Pitchfork 

• Andrews PitchforkV3.3 

• AO+ Momentum indicator 

• AO+Momentum 

• Aroon 

• Aroon The Advisor 

• AR_Prediction.afl 

• ATR Study 

• Auto Trade Step by Step 

• Auto-Optimization Framework 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• Automatic Trend-line 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• AutoTrade using an Exploration 

• Average Dollar Price Volatility Exploration 

• Average Price Crossover 

• Awsome Oscilator 

• babaloo chapora 

• Bad Tick Trim on 5 sec database 

• Balance of Power 

• balance of power 

• Basket Trading System T101 

• BB squeeze 

• BEANS-Summary of Holdings 

• Bollinger Band Gap 

• Bollinger Fibonacci Bands 

• Bottom Fisher Exploration 

• Brian Wild 

• Bull/Bear Volume 

• Bullish Percent Index 2 files combined 

• Bullish Percent Index 2004 

• CAMSLIM Cup and Handle Pattern AFL 

• Candle Stick Analysis 

• Candle Stick Demo 

• Candlestick Commentary 

• Candlestick Commentary Modified 

• Candlestick Commentary-modified 

• Candlestick Volume Bars with Moving Average 

• CandleStochastics 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI Woodies Style 

• CCI(20) Divergence Indicator 


Ilf- immediate IF function 
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• Centre of Gravity 

• Chande Momentum Oscillator 

• Chande's Trend Score 

• Chandelier Exit or Advanced Trailing Stop 

• changing period moving average 

• Channel/S&R and trendlines 

• CoinToss ver 1 

• Cole 

• Color Coded Short Term Reversal Signals 

• Color Display.afl 

• Color MACD Histogram Changes 

• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• Colorfull Price 

• com-out 

• COMBO 

• Compare Sectors against Tickers 

• Congestions detection 

• Connors TPS 

• ConnorsRSI 

• Continuous Contract Rollover 

• Coppock Histogram 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• crMathLib 

• CVR-severe filter 

• Cyber Cycle 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Cycle Period 

• Daily High Low in Advance 

• Dave Landry PullBack Scan 

• Dave Landry Pullbacks 

• Days to Third Friday 

• De Mark's Range Projection 

• DEBAJ 

• Demand Index 

• Demand Index 

• DeMarker 

• DINapolis 3x Displaced Moving Averages 

• Distance Coefficient Ehlers Filter 

• Divergences 

• DMI Spread Index 

• Dynamic Momentum Index 

• Dynamic Momentum Index 

• Dynamtic Momentum Index 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• Effective Swing Indicator 

• ekeko price chart 

• EKEKO SAR-MF 

• Elder Impulse Indicator 


Ilf- immediate IF function 
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• Elder Impulse Indicator V2 

• Elder Ray Oscillator with MA 

• Elder safe Zone Long + short 

• Elder's Market Thermometer 

• Elder's SafeZone Stop 

• ElderSafeZoneStopLong 

• ElderSafeZoneStopShort 

• Elliott Wave Oscillator 

• End Of Year Trading 

• Expiry day/days - Last thursday of month 

• Expiry Thursday for Indian markets 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• FastStochK FullStochK-D 

• Fib CMO 

• Fib Fan Based on ZZ 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• Fisher Centre of Gravity 

• Fisher Cyber Cycle 

• Fisher Oscillator 

• Fisher Relative Vigour Index 

• Follow the Leader 

• Fre 

• Fund Screener 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gann HILo Indicator and System 

• Gann level plotter 

• Gann Swing Chart 

• Gann Swing chart v41212 

• Gann Swing Charts In 3 modes with text 

• garythompson 

• garythompson 

• GFX ToolTip 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• half-automated Trading System 

• Harmonic Patterns 

• Head & Shoulders Pattern 

• Heatmap V1 

• Helkin AshI Delta 

• HH-LL-PrIceBar 

• Hilbert Study 

• Hull Moving Average 

• Hurst "Like" DE 

• Hurst Constant 

• IBD relative strength database Viewer 

• Ichimoku KInko Hyo 

• ICHIMOKU SIGNAL TRADER 

• IchImokuBrIanVIoreIRO 

• IFT of RSI - Multiple TImeFrames 


Ilf- immediate IF function 
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• Indicator Explorer (ZigZag) 

• Instantaneous Trend Line 

• Intraday Average Volume 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 

• IntraDay Open Marker 

• Intraday Range and Periods Framer 

• Intraday Trend Break System 

• Intraday Volume EMA 

• Inverted Plotted Volume Overlay Indicator 

• JEEVAN'S SRI CHAKRA 

• Jesse Livermore Secret Market Key 

• Kagi Chart 

• Kiss and Touch with the Modified True Range 

• Lagging MA-Xover 

• Larry William's Volatility Channels 

• Last Five Trades Result Dashboard - AFL code 

• lastNDaysBeforeDate 

• Linear Regression Line w/ Std Deviation Channels 

• Luna Phase 

• Lunar Phases - original 

• LunarPhase 

• MA Difference 20 Period 

• MACD indicator display 

• Main price chart with Rainbow & SAR 

• Market Facilitation Index VS Volume 

• Market Profile 

• MDYtoXLSerialDays and XLSerialDaysToDateNum 

• Meu Sistema de Trading - versao 1.0 

• MFE and MAE and plot trades as indicator 

• mfimacd 

• mitalpradip 

• Modified Head & Shoulder Pattern 

• Modified-DVI 

• Monthly bar chart 

• Moving Average "Crash" Test 

• Moving Averages NoX 

• MS Darvas Box with Exploration 

• Multicycle 1.0 

• Multiple Ribbon Demo 

• N Line Break Chart 

• N-period candlesticks (time compression) 

• NASDAQ 100 Volume 

• Next Date Format 

• Nick 

• nikhil 

• Non-repaitning Zigzag line 

• Nonlinear Ehlers Filter 

• NoorDoodie 

• nth (1 - 8 ) Order Polynomial Fit 

• Option Calls, Puts and days till third friday. 

• Ord Volume 


Ilf- immediate IF function 
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• P&F Chart - High/Low prices Sept2003 

• P&F chart with range box sizes 

• Parametric Chande Trendscore 

• Percentage Price Osciiiator 

• Perceptron 

• Performance Check 

• Peterson 

• PF Chart - Close - April 2004 

• Pivot End Of Day Trading System 

• Pivot Finder 

• Pivots for Intraday Forex Charts 

• Plot visual stop / target ratio. 

• Point & figure Chart India Securities 

• Polarized Fractal Efficiency 

• Position Sizer vers2, stocks and CFDs 

• Position Sizing and Risk Price Graph 

• Position Sizing and Risk Price Graph - 2 

• Prashanth 

• Price Chart - Fundamental 

• Price with Woodies Pivots 

• Price-Volume Rank 

• PVT Trend Decider 

• QP2 Float Analysis 

• R-Squared 

• Rainbow Oscillator 

• Range Expansion Index 

• Ranking Ticker WatchList 

• Raw ADX 

• Rea Time Daily Price Levels 

• Regression Analysis Line 

• Relative Momentum Index (RMI) 

• Relative Strength Multichart of up to 10 tickers 

• Relative Vigour Index 

• Relative Vigour Index 

• Rl - Auto Trading System 

• ROC of MACD Weekly 

• RSI of Weekly Price Array 

• RSI styleClipMinMax 

• RSI Trendlines and Wedges 

• RSIS 

• RUTVOL timing signal with BB Scoring routine 

• Sainath Sidgiddi 

• Scale Out: Futures 

• Schiff Lines 

• SectorRSI 

• shailu lunia 

• Square of Nine Roadmap Charts 

• Standard Error Bands (Native AFL) 

• STD_STK Multi 

• Steve Woods' Cum. Vol. Float -i- Cum. Vol. Channels 

• Steve Woods' Cumulative Vol. Percentage Indicator 

• Stochastic Centre of Gravity 


Ilf- immediate IF function 
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• Stochastic Cyber Cycle 

• Stochastic Divergence, negative 

• Stochastic Divergence, positive 

• Stochastic Divergences, PDI, NDI 

• Stochastic Fast%K and Full 

• Stochastic Relative Vigour Index 

• Stochastic RSI 

• Stochastics Trendlines 

• Stress with SuperSmoother 

• Sun&Cloud 

• SUPER PIVOT POINTS 

• Super Trend Indicator 

• Support and Resistance 

• suresh 

• TD Moving Average 2 

• TD Moving Average I 

• TD REI 

• TD sequential 

• TD Sequential 

• The Fibonaccian behavior 

• The Mean RSIt 

• The Mean RSIt (variations) 

• The Saturation Indicator D_sat 

• Three Day Balance Point 

• Three Pole Butterworth 

• Time Left in Bar 

• Time segment value 

• tomy_frenchy 

• Tracking Error 

• Trading ATR 10-1 

• Trailing Stop Loss 

• Trend Continuation Factor 

• Trend Detection 

• Trend exploration with multiple timeframes 

• Trend Exploration: Count Number of New Highs 

• Trend Exploration: Slope Moving Average 

• Trend Following System 

• TRENDAdvisor 

• Trending Ribbon 

• TrendingRibbonArrowsADX 

• Triangle exploration using P&F Chart 

• Triangular Moving Average 

• Triangular Moving Average new 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Trix Bars number 

• TTM Squeeze 

• Twiggs Money Flow 

• Twiggs money flow weekly 

• TWS auto-export Executions-file parser 

• TWS trade plotter 

• Using From and To dates from Auto Analysis in Code 

• ValueChart 


Ilf- immediate IF function 
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• Vic Huebner 

• Vikram's Floor Pivot Intraday System 

• Visualization of stoploses and profit in chart 

• Vivek Jain 

• Volatility 

• Volatility System 

• Volume - compared with Moving Avg (100%) 

• Volume Color with Dynamic Limit 

• Volume Occilator 

• Volume Oscillator 

• VSTOP (2) 

• VSTOP (3) 

• VWAP versus Average Price 

• Weekly chart 

• Weekly Trend in Daily Graph 

• Weinberg's The Range Indicator 

• William's Alligator System II 

• Williams Alligator system 

• WILSON RELATIVE PRICE CHANNEL 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

• Woodies CCI 

• Zig Zag 

• Zig Zag Indicator with Valid Entry and Exit Points 

• Zig-Hi Zap-Lo 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


Ilf- immediate IF function 
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MR 

- infinite impuise response fiiter 


Moving averages, summation 

(AFL 4.0) 


SYNTAX iiR( input, bO = 1, a1 = 0, b1 = 0, a2 = 0, b2 = 0, a3 = 0, b3 = 0, a4 = 0, b4 = 0 ) 

RETURNS ARRAY 

FUNCTiON The function implements fast 4th-order infinite impulse response filter. 

Analytically it is: 

y[ n ] = bO * x[ n ] + b1 * x[ n - 1 ] + b2 * x[ n - 2 ] + b3 * x[ n - 3 ] + b4 * x[ n - 4 ] + a1 * y[ n - 1 
] + a2 * y[ n - 2 ] + a3 * y[ n - 4 ] + a4 * y[ n -4 ]; 

AFL equivalent: 

y = x; // init so no glitches at the beginning appear 


for ( n 

r 

= 4; n 

< 

BarCount; 


n++ ) 

1 

y[ n ] 

= bO * 

x[ 

; n 

] 

+ 




bl 

■k 

x[ 

n 

- 1 

] 

+ 


b2 

■k 

x[ 

n 

- 2 

] 

+ 


b3 

k 

x[ 

n 

- 3 

] 

+ 


b4 

k 

x[ 

n 

- 4 

] 

+ 


al 

k 

y[ 

n 

- 1 

] 

+ 


a2 

k 

y[ 

n 

- 2 

] 

+ 


a3 

k 

y[ 

n 

- 4 

] 

+ 

} 

a4 

k 

y[ 

n 

- 4 

] 

r 

Filters of 

orders 3 

and 2 ( 

zan 

be implemented by leaving unneeded arguments at default 


value of zero. 

Coefficients bO, b1, b2, b3, b4 multiply the input signal x[n] and are referred to as the 
feedforward coefficients. Coefficients a1, a2, a3, a4 multiply the output signal y[n] and are 
referred to as the feedback coefficients. Pay careful attention to the sign of the feedback 
coefficients. Some design tools flip the sign of the feedback coefficients. In this case the 
feedback coefficients must be negated. 

This convention is used so feedback coefficients work the same as in AMA2 in case of first 
order filter, so 

IIR( array, factor, 1-factor) 

is the same as 

AMA2( array, factor, 1 -factor) 

(with very minor difference is that MR uses internally double precision arithmetic while AMA2 
uses single precision) 


HR - infinite impulse response filter 
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EXAMPLE 

// simple ema: 

factor = 2 /(period+1); 

y = IIR( input, factor, 1- factor ); 

// Wilders: 
factor = 1/period 

z = IIR( input, factor, 1-factor ); 

// Ehlers Supersmoother 

Periods = 10; 

cl = 1.41421 * 3.14159 / Periods; 

c2 = 2.71828''-cl; 

al = 2 * c2 * cos ( cl ); 

a2 = -c2^2; 

bO = (1 - al - a2)/2; 

bl = bO; 

SEE ALSO 

X = IIR( Close, bO, al, bl, a2 ); 

Plot ( X, "Super Smoother", colorRed ); 

AMA() function , AMA2() function 

References: 



The MR function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-line reference 


HR- infinite impulse response filter 
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IndustrylD 

- get industry ID / name 


Information / Categories 

(AFL 1.8) 


SYNTAX lndustrylD( mode = 0 ) 
RETURNS NUMBER/STRING 


FUNCTION Retrieves current stock industry ID/name When mode = 0 (the defauit vaiue ) this function 
returns numericai industry ID (consecutive industry number) 

When mode = 1 this function returns name of the industry. 

EXAMPLE Fiiter = IndustrylDQ == 7 OR lndustrylD() == 9; 

AddTextCoiumn( lndustrylD( 1 ), "Industry name"); 

SEE ALSO 
References: 


The IndustrylD function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Dave Landry PuiiBack Scan 

• Eider Tripie Screen Trading System 

• qp2 industry charts as a panei in the stocks chart 

More information: 

Updated on-iine reference 


IndustrylD - get industry ID / name 
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InGICS Information / Categories 

- test GIGS membership (A'"'- ^ 40) 


SYNTAX lnGICS( "gics_code") 

RETURNS NUMBER (0 or 1) 

FUNCTION The function performs yes/no test if current symboi beiongs to given GIGS category for 
exampie if GIGS set for the symboi is 15103020 lnGics("15"), lnGIGS("1510"), 
lnGics("151030") and lnGics("15103020") wiii ALL return true but aii others (iike lnGics("20")) 
wiii return faise. 


EXAMPLE printf( 

"GICS (0) 

= " + GicsID( 

0 ) 

) ; 

printf ( 

"GICS (1) 

= " + GicsID( 

1 ) 

) ; 

printf ( 

"GICS (2) 

= " + GicsID( 

2 ) 

); 

for ( i = 

= 10; i < 

90; i+= 1 ) 




gics_code = StrFormat ( "%02.Of" , i ) ; 
printfC'In Gics ' "+ gics_code + "' = 

} 


%g\n", InGics ( gics_code 


) ; 


SEE ALSO GicsIDQ function , lnWatchList() function , lnWatchListName() function 

References: 


The InGics function is used in the foliowing formulas in AFL on-line library: 

More information: 


Updated on-line reference 


InGics - test GICS membership 
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InICB Information / Categories 

- test ICB membership ^ 


SYNTAX 

lnlCB("icb_code") 

RETURNS 

NUMBER (Oor 1) 

FUNCTION 

The function performs yes/no test if current symbol belongs to given ICB category for 
example if ICB set for the symbol is 9537, lnlCB("9000"), lnlCB("9500"), lnlCB("9530") and 
lnlCB("9537") will ALL return true but all others (like lnlCB("5000")) will return false. 

EXAMPLE 

printf ( "ICB(O) = " + IcbID ( 0 ) ); 
printf( "ICB(l) = " + IcbID ( 1 ) ); 
printf ( "ICB(2) = " + IcbID ( 2 ) ); 

for ( i = 10; i < 90; i+= 1 ) 

SEE ALSO 

1 

ICB_code = StrFormat ( "%02.Of" , i ); 

printf ("In ICB '"+ ICB_code + "' = %gn", Inlcb( ICB_code ) ); 

} 

lnlCB() function 

References: 



The InICB function is used in the foliowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 


InICB - test ICB membership 
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Inside Basic price pattern detection 

- inside day 

SYNTAX insideO 

RETURNS ARRAY 

FUNCTiON Gives a "1" or "true" when an inside day occurs.Gives "0" otherwise. An inside day occurs 
when today's high is iess than yesterday's high and today's iow is greater than yesterday's 
iow. 

EXAMPLE 

SEE ALSO 
References: 

The inside function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Advisory NRx price chart dispiay. 

• Gann Five Day puiiback 

• Gann Swing Chart 

• NRx Expioration 

• Vic Huebner 

More information: 

Updated on-line reference 


Inside - inside day 
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Math functions 


Int 

- integer part 


SYNTAX lnt( NUMBER) 
int( ARRAY) 

RETURNS NUMBER 
ARRAY 


FUNCTION Removes the fractional portion of NUMBER or ARRAY and returns the integer part. 
EXAMPLE The formula "int( 10.7 )" returns 10; the formula "int(-19.8 )" returns -19. 

SEE ALSO The ceilQ function; the floor() function; the frac() function. 

References: 


The Int function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• Adaptive Centre of Gravity 

• Adaptive Relative Vigour Index 

• AFL Timing functions 

• AutoTrade using an Exploration 

• Bad Tick Trim on 5 sec database 

• Baseline Relative Performance Watchlist charts V2 

• Bullish Percent Index 2 files combined 

• Candle Stick Demo 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• Color Display.afl 

• Continuous Contract Rollover 

• Cybernertic Hilbert Sine Wave 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Dominant Cycle Phase 

• Dynamtic Momentum Index 

• Fibonacci Calculations & Speed Resistance 

• Gartley 222 Pattern Indicator 

• Heatmap VI 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• Hull Moving Average 

• Hull with DEMA 

• Hurst "Like" DE 

• Hurst Constant 

• John Ehler 

• Kagi Chart 

• Log Time Scale 

• Lunar Phases - original 

• LunarPhase 

• MDYtoXLSerialDays and XLSerialDaysToDateNum 


Int - integer part 
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• Modified Momentum Finder DDT-NB 

• Modified-DVI 

• Muitipie Ribbon Demo 

• Probabiiity Density & Gaussian Distribution 

• RandomizeO 

• Signai to Noise 

• Sine Wave Indicator 

• Smoothed Adaptive Momentum 

• Standard Error Bands 

• Time Left to Current Bar 

• Triangie expioration using P&F Chart 

• VAMA 

• Visi-Trade 

• Woodie's CCI Panei Basic 

• Woodie's CCI Panel Full Stats 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


Int- integer part 
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Interval 

- get bar interval (in seconds) 


Date/Time 

(AFL 2.1) 


SYNTAX IntervaK format = 0 ) 

RETURNS NUMBER 

FUNCTION IntervalO function returns bar interval. 

Possible formats: 


• format = 0 - returns bar interval in seconds 

• format = 1 - as above plus TICK bar intervals are returned with negative sign so 
IntervalO function applied to 10 tick chart will return -10 

• format = 2 - returns STRING with name of interval such as 
"Weekly/Monthly/Daily/Hourly/15-minute/5-tick" 

Example time intervals in seconds: 
tick bars = 0 
5 sec bars = 5 

1 min bars = 60 (inMinute constant) 
hourly bars = 3600 
daily bars = 86400 (InDaily constant) 
weekly bars = 432001 (inWeekly constant) 
monthly bars = 2160001 (inMonthly constant) 

Caveat: it is bad idea to use text comparision like this if( lnterval(2) == "Weekly") {}. Do NOT 
do that, because as soon as localized version of AmiBroker arrives, your code will be broken 
as names will be translated. Use NUMERIC comparison, such as: if( IntervalO == inWeekly ) 

{} instead. 

EXAMPLE "Interval in seconds " -i- WriteVal( IntervalO ); 

SEE ALSO 
References: 


The Interval function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• AFL Timing functions 

• Alternative ZIG type function, multi TF 

• Auto Trader Basic Flow 

• Automatic Trendlines using multiple timeframes 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• candlestick chart for Volume/RSI/OBV 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI Woodies Style 

• Channel/S&R and trendlines 


Interval - get bar interval (in seconds) 
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• Chart Zoom 

• Commodity Selection Index (CSI) 

• Continuous Contract Rollover 

• DPO with shading 

• ekeko price chart 

• Export EOD or Intraday to .csv file 

• Fibonacci Internal and External Retracements 

• Harmonic Patterns 

• Heatmap V1 

• Heinkin-Ashi 

• IBD relative strength database Viewer 

• Improved NH-NH scan / indicator 

• Intraday Average Volume 

• Inverted Plotted Volume Overlay Indicator 

• Kelly criterion 

• Last Five Trades Result Dashboard - AFL code 

• Market Breadth Chart-In-Chart 

• MFE and MAE and plot trades as indicator 

• Modified Head & Shoulder Pattern 

• Price with Woodies Pivots 

• Rea Time Daily Price Levels 

• Super Trend Indicator 

• suresh 

• Time Left in Bar 

• Time Left to Current Bar 

• Volume Color with Dynamic Limit 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


Interval- get bar interval (in seconds) 
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InWatchList information / Categories 

- watch list membership test (by ordinal number) 


SYNTAX 

lnWatchList( listno) 

RETURNS 

NUMBER 

FUNCTION 

Checks if the stock belongs to a watch list number listno. If yes - the function returns 1 
otherwise 0. 

EXAMPLE 

Filter= lnWatchList( 3 ) OR lnWatchList( 5 ); 

SEE ALSO 

References: 

InWatchListNameQ function 


The InWatchList function is used in the foilowing formulas in AFL on-line library: 

• Count Tickers in Watchlist 

• In Watch List 

More information: 

Updated on-line reference 


InWatchList - watch list membership test (by ordinal number) 
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InWatchListName 

- watch list membership test (by name) 


Information / Categories 

(AFL 3.0) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


lnWatchListName( "name") 

NUMBER 

Checks if the stock belongs to a watch list number "listname". If yes - the function returns 1 
otherwise 0. 

Filter= lnWatchListName( "My Hotlist") OR lnWatchList( "My Second Hotlist"); 
InWatchListO function 


The InWatchListName function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


InWatchListName - watch list membership test (by name) 
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IsContinuous 

- checks 'continuous quotations' fiag state 


Information / Categories 

(AFL 2.60) 


SYNTAX IsContinuousO 

RETURNS NUMBER 

FUNCTION Returns 1 if current symbol has 'continuous quotations' flag turned on in Symbol->lnformation 
window. Returns zero otherwise. 


EXAMPLE 

SEE ALSO 
References: 


The IsContinuous function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


IsContinuous - checks 'continuous quotations' flag state 
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IsEmpty 

- empty value check 


Miscellaneous functions 

(AFL 1.5) 


SYNTAX lsEmpty( ARRAY) 

RETURNS ARRAY 

FUNCTION returns 1 (or 'true') when given point in array is {empty} 

Note: (empty) vaiue is used internaiy by AFL to mark 
bars when the vaiue is not avaiiabie - for exampie for the first 
20 bars the vaiue of 20-day simpie moving average is not avaiiabie 
({empty}) 


IsNull is a synonym for IsEmpty. It is suggested to use IsNuli in new formuias, because of 
naming consistency with Nuil constant. 

EXAMPLE movagv = ma( close, 30 ); 

WritelF( IsEmpty( movavg ), "Moving average not available yet", 
WriteVal( movavg ) ) ; 


SEE ALSO ISEMPTYQ function , ISNAN() function , ISNULL() function , ISTRUEQ function 

References: 


The IsEmpty function is used in the foilowing formulas in AFL on-line library: 

• AFL Timing functions 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• Channel/S&R and trendlines 

• Elder safe Zone Long -i- short 

• Fre 

• Fund Screener 

• lastNDaysBeforeDate 

• MACD indicator display 

• Probability Density & Gaussian Distribution 

• QP2 Float Analysis 

• Weekly chart 

• Zig Zag 

More Information: 

Updated on-line reference 


IsEmpty - empty value check 
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IsFavorite 

- check if current symbol belongs to favorites 


Information / Categories 

(AFL 2.5) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 


IsFavoriteO 

NUMBER 

The IsFavorite function returns True (1) if current symboi beiongs to favorites, returns Faise 
(0) otherwise. 

if ( IsFavoriteO ) 

{ 

printf ( NameO + " belongs to favourites " ); 

} 


SEE ALSO IsIndexO function 

References: 


The IsFavorite function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 


Updated on-line reference 


IsFavorite - check if current symbol belongs to favorites 
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IsFinite 

- check if value is not infinite 


Miscellaneous functions 

(AFL 2.3) 


SYNTAX lsFinite( x) 

RETURNS NUMBER, ARRAY 

FUNCTION returns a nonzero value (1 or TRUE) if its argument x is not infinite, that is, if INF < x < 
+INF. It returns 0 (FALSE) if the argument is infinite or a NaN. 


X can be number or array 
EXAMPLE lsFinite( 1/0 ); 

SEE ALSO NZ() function , ISNANQ function 

References: 


The IsFinite function is used in the following formulas in AFL on-line library: 

• AR_Prediction.afl 

• Automatic Linear Trend Channel 

• tomy_frenchy 

• Trigonometric Fit - TrigFit with AR for cos / sin 

More information: 

Updated on-line reference 


IsFinite - check if value is not infinite 
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Isindex 

- check if current symbol is an index 


Information / Categories 

(AFL 2.5) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 


IsIndexQ 

NUMBER 

The Isindex function returns True (1) if current symboi is an index, returns Faise (0) 
otherwise. 

if ( Isindex () ) 

{ 

printf ( NameO + " is an index" ); 

} 


SEE ALSO IsFavoriteQ function 

References: 


The Isindex function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 


Updated on-line reference 


Isindex - check if current symbol is an index 
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IsNan 

- checks for NaN (not a number) 


Miscellaneous functions 

(AFL 2.3) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


lsNan( X) 

NUMBER, ARRAY 

Returns a nonzero value (1 or TRUE) if the argument x is a NaN; otherwise it returns 0 
(FALSE). A NaN is generated when the result of a floating-point operation cannot be 
represented in Institute of Electrical and Electronics Engineers (IEEE) format. 

lsNan( 0/0); 

NZ() function 


The IsNan function is used in the following formulas in AFL on-line library: 

• AR_Prediction.afl 

• tomy_frenchy 

• Trigonometric Fit - TrigFit with AR for cos / sin 

More Information: 

Updated on-line reference 


IsNan - checks for NaN (not a number) 
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IsNull 

- check for Null (empty) value 


Miscellaneous functions 

(AFL 2.3) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 


IsNull(x) 

NUMBER, ARRAY 

this function is synonym of isEmpty(). Gives True if vaiue is equai to Nuii (empty) vaiue. 

movagv = ma( close, 30 ); 

WritelF( IsNull( movavg ), "Moving average not available yet", 
WriteVal( movavg ) ) ; 


SEE ALSO iSEMPTYQ function 

References: 


The IsNull function is used in the foiiowing formuias in AFL on-iine iibrary: 

• AR_Prediction.afi 

• Auto-Optimization Framework 

• AutoTrade using an Expioration 

• Basket Trading System T101 

• Chandeiier Exit 

• Congestions detection 

• Fieatmap V1 

• Fiistoricai Voiatiiity index 

• Rene Rijnaars 

• tomy_frenchy 

• Trend Lines from 2 points 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• TWS trade piotter 

• Visi-Trade 

More Information: 


Updated on-iine reference 


IsNull - check for Null (empty) value 
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IsTrue 

- true value (non-empty and non-zero) check 

SYNTAX istrue( ARRAY) 

RETURNS ARRAY 

FUNCTION returns 1 (or 'true') when given point is not {empty} AND not zero 

EXAMPLE 

SEE ALSO 
References: 

The IsTrue function is used in the foliowing formulas in AFL on-line library: 

• Cycle Highlighter (auto best-fit) 

• FirstBarIndexO, LastBarlndex() 

• Relative Strength Multichart of up to 10 tickers 

More Information: 

Updated on-line reference 


Miscellaneous functions 

(AFL 1.5) 


IsTrue - true value (non-empty and non-zero) check 
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LastValue Trading system toolbox 

- last value of the array 


SYNTAX LastValue(ARRAY, lastmode = True ) 

RETURNS NUMBER 

FUNCTION Returns last calculated value of the specified ARRAY. The result of this function can be used 
In place of a constant (NUMBER) In any function argument. 

If ARRAY Is undefined (e.g., only 100-days loaded and you request the last value of a 
200-day moving average) then the lastvalue function returns zero. 

Caveat: since this function fills an entire data array with the last value of another array, It 
allows a formula to look Into the future. 


lastmode parameter: 

(affects only commentary/interpretation) 

When It Is True - then true last value Is used always 

If It Is False - then In commentary the 'selected' value Is returned 

In pre-4.08.1 versions commentary/interpretatlon/tooltip code evaluation was somewhat 
special because LastValue returned In fact not the last but the value of array at selected 
point (by vertical line or by tooltip) This caused some problems In displaying Indicator values 
that used LastValue In Its construction. To address this now LastValue used In 
Commentaries by default returns true last value. So you should modify your existing 
commentary/interpretation code that used LastValue to use now SelectedValue( array ) 
function to maintain the same behaviour. Alternatively you can use LastValue( array, 0 ). 


EXAMPLE 

SEE ALSO SELECTEDVALUEO function 

References: 


The Lastvalue function Is used In the following formulas In AFL on-line library: 

• Pivots And Prices And Swing Volume 

• 2 Timeframes Candlestick Bar Chart 

• 3 Price Break 

• 3TF Candlestick Bar Chart 

• Advanced Trend Lines with S & R 

• Alpha and Beta and R_Squared Indicator 

• AR_Predlctlon.afl 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• Auto-Optimizatlon Framework 

• Automatic Trend-line 

• Automatic Trendlines using multiple timeframes 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• babaloo chapora 

• Basket Trading System T101 

• BEANS-Summary of Holdings 


Lastvalue - last value of the array 
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• Bullish Percent Index 2 files combined 

• Button trading using AB auto trading interface 

• Candle Stick Analysis 

• Candle Stick Demo 

• CCI(20) Divergence Indicator 

• Chart Zoom 

• Color Display.afl 

• Congestions detection 

• Continuous Contract Rollover 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Dave Landry PullBack Scan 

• DMI Spread Index 

• ekeko price chart 

• Elder Triple Screen Trading System 

• Expiry day/days - Last thursday of month 

• Export EOD or Intraday to .csv file 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Fib Fan Based on ZZ 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• FirstBarIndexO, LastBarlndex() 

• Frequency distribution of returns 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Futures - Dollar Move Indicator 

• Gann Swing Chart 

• Gann Swing Charts in 3 modes with text 

• GFX ToolTip 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Harmonic Patterns 

• Head & Shoulders Pattern 

• Heatmap V1 

• Hurst "Like" DE 

• Hurst Constant 

• Improved NH-NH scan / indicator 

• Intraday Fibonacii Trend Break System 

• Intraday Range and Periods Framer 

• Intraday Trend Break System 

• Intraday Volume EMA 

• Inverted Plotted Volume Overlay Indicator 

• JEEVAN'S SRI CHAKRA 

• Kagi Chart 

• Last Five Trades Result Dashboard - AFL code 

• Linear Regression Line & Bands 

• Linear Regression Line w/ Std Deviation Channels 

• MACD commentary 

• MACD indicator display 

• Manual Bracket Order Trader 

• Market Profile 


LastValue - last value of the array 
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• Modified Head & Shouider Pattern 

• Modified Momentum Finder DDT-NB 

• Monthiy bar chart 

• Moving Average "Crash" Test 

• Moving Averages NoX 

• Multiple sinus noised 

• Murrey Math Price Lines 

• N-period candlesticks (time compression) 

• Now Send Push Notifications From Amibroker 

• nth (1 - 8 ) Order Polynomial Fit 

• P&F Chart - High/Low prices Sept2003 

• Pattern Recognition Exploration 

• PF Chart - Close - April 2004 

• Pivot Finder 

• Pivot Point with S/R Trendlines 

• Point & figure Chart India Securities 

• Prashanth 

• Price Persistency 

• QP2 Float Analysis 

• Ranking and sorting stocks 

• Rea Time Daily Price Levels 

• Regression Analysis Line 

• Relative Strength Multichart of up to 10 tickers 

• Renko Chart 

• RSI Trendlines and Wedges 

• shailu lunia 

• STD_STK Multi 

• Steve Woods' Cum. Vol. Float + Cum. Vol. Channels 

• Steve Woods' Cumulative Vol. Percentage Indicator 

• Stochastics Trendlines 

• StochD_StochK Single.afl 

• SUPER PIVOT POINTS 

• Support Resistance levels 

• The Fibonaccian behavior 

• Time Left in Bar 

• Time Left to Current Bar 

• Tom DeMark Trend Lines 

• Triangle exploration using P&F Chart 

• Triangle search 

• Triangle Search Extended 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Using From and To dates from Auto Analysis in Code 

• Visible Min and Max Value Demo 

• Weekly chart 

• Williams Alligator system 

• WLBuildProcess 

• Zig Zag Indicator with Valid Entry and Exit Points 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 


LastValue - last value of the array 
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More information: 

Updated on-line reference 


LastValue- last value of the array 
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LastVisibleValue 
- get last visible value of array 


Indicators 

(AFL 3.40) 


SYNTAX LastVisibleValue( array) 

RETURNS NUMBER 

FUNCTION When used in charts / indicators /interpretation the function returns the vaiues of array at the 
iast visibie bar. 

In other (non-indicator) modes the function returns array eiement with subscripts of 
BarCount-1. 


Note that these functions do not affect QuickAFL, so LastVisibieValue may be used instead 
of LastVaiue These functions are intended to compiement functionaiity already available via 
HighestVisibleValue and LowestVisibleValue. 

EXAMPLE X = C; 

Plot ( X, "x", colorRed ); 

Plot ( FirstVisibleValue ( x ), "fvv", colorGreen ); 

Plot ( LastVisibleValue ( x ), "Ivv", colorBlue ); 

SEE ALSO FirstVisibleValueO function , HighestVisibleValue() function , LowestVisibleValue() function 

References: 


The LastVisibleValue function is used in the following formulas in AFL on-line library: 

• Alternative ZIG type function, multi TF 

• Channel/S&R and trendlines 

• Congestions detection 

More information: 


Updated on-line reference 


LastVisibleValue - get last visible value of array 
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LineArray 

- generate trend-line array 


Exploration / Indicators 

(AFL 2.5) 


SYNTAX LineArray( xO, yO, x1, y1, extend = 0, usebarindex = False} 

RETURNS ARRAY 

FUNCTION The LineArray function generates array equivalent to trend line drawn from point (xO, yO) to 
point (x1, y1). X coordinates are in bars (zero based), y coordinates are in dollars. 

Note: xO must be SMALLER than x1. 

Note 2: the function accepts only numbers therefore generates single line. To produce 
multiple lines you have to call it many times with different co-ordinates. 

extend parameter controls automatic extension of the trend line: if extend is 1 then line is 
right extended, if extend is 2 then line is left extended if extend is 3 then line is left and right 
extended 


usebar/nc/ex parameter controls if x coordinates are interpreted as current array indexes 
(from O..BarCount-1) (when usebarindex = False) or as absolute bar indexes (returned by 
BarIndexO function) when usebarindex = True. These two may differ if QuickAFL feature is 
turned on. 

EXAMPLE yO =LastValue(Trough (L, 5,2)); 

yl=LastValue(Trough (L, 5,1)); 

xO=BarCount - 1 - LastValue(TroughBars (L, 5, 2 )); 
xl=BarCount - 1 - LastValue(TroughBars (L, 5, 1 )); 

Line = LineArray ( xO, yO, xl, yl, 1 ); 

Plot (C, "C", colorWhite, styleCandle) ; 

Plot ( Line, "Trend line", colorBlue ); 


SEE ALSO 
References: 


The LineArray function is used in the following formulas in AFL on-line library: 

• 3 Price Break 

• Advanced Trend Lines with S & R 

• Another Fib Level 

• CCI(20) Divergence Indicator 

• Congestions detection 

• Fib Fan Based on ZZ 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gartley 222 Pattern Indicator 

• Gordon Rose 

• Harmonic Patterns 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 


LineArray - generate trend-line array 
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• JEEVAN'S SRI CHAKRA 

• Non-repaitning Zigzag line 

• PF Chart - Close - April 2004 

• Pivot Point with S/R Trendlines 

• Point & figure Chart India Securities 

• Rea Time Daily Price Levels 

• Square of Nine Roadmap Charts 

• TD Sequential 

• Tom DeMark Trend Lines 

• Trend Lines from 2 points 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Full Stats 

• ZigZag Retracements 

More information: 

Updated on-line reference 


LineArray- generate trend-line array 
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LinearReg 

- linear regression end-point 


Statistical functions 

(AFL 2.2) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


LinearReg( ARRAY, periods) 

ARRAY 

Calculates linear regression line end-point value according to a -i- b * x (where a and b are 
Intercept and slope of linear regression line) from the ARRAY using periods range. The 
function accepts periods parameter that can be constant as well as time-variant (array). 

LlnearReg( close, 10); 


The LinearReg function Is used In the following formulas In AFL on-line library: 


• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• Average Price Crossover 

• CCI Woodies Style 

• DEBAJ 

• Hull Range Indicator 

• Hull Rate of Return Indicator 

• Moving Trend Bands (MTB) 

• Price with Woodies Pivots 

• Standard Error Bands (Native AFL) 

• Trend Detection 

• Woodle's CCI Panel Basic 

• Woodle's CCI Panel Full Stats 

• Woodle's Price Panel With Woodle's Pivots 


More information: 

Updated on-line reference 


LinearReg - linear regression end-point 
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LinRegIntercept 


Statistical functions 

(AFL 2.2) 


SYNTAX LinReglntercept( ARRAY, periods} 

RETURNS ARRAY 

FUNCTION Calculates Intercept of linear regression line - the "a" coefficient 

In a + b*x (LInRegSlope calculates b) from the ARRAY using periods range. The function 
accepts periods parameter that can be constant as well as time-variant (array). 

EXAMPLE x = Cum(1); 

lastx = LastValue( x ); Daysback = 10; aa = LastValue( LlnReglntercept( Close, Daysback)); 
bb = LastValue( LlnRegSlope( Close, Daysback)); 

y = Aa -r bb * ( X - (Lastx - DaysBack)); Plot( Close, "Close", colorBlack, styleCandle ); 

Plot( llf( X >= (lastx - Daysback), y, -lelO ), "LInReg", colorRed ); 

SEE ALSO 
References: 


The LinRegIntercept function Is used In the following formulas In AFL on-line library: 

• AR_Predlctlon.afl 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• correlerror 

• Dave Landry PullBack Scan 

• Linear Regression Line w/ Std Deviation Channels 

• OBV with Linear Regression 
• regavg 

• Trigonometric Fit - TrIgFIt with AR for cos / sin 

More information: 


Updated on-line reference 


LinRegIntercept - 
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LinRegSlope 
- linear regression slope 


Statistical functions 

(AFL 1.4) 


SYNTAX LinRegSlope( ARRAY, periods ) 

RETURNS ARRAY 

FUNCTION Calculates linear regression line slope from the ARRAY using periods range. The function 
accepts periods parameter that can be constant as well as time-variant (array). 

EXAMPLE x = Cum(1); 

lastx = LastValue( x ); Daysback = 10; aa = LastValue( LlnReglntercept( Close, Daysback)); 
bb = LastValue( LlnRegSlope( Close, Daysback)); 

y = Aa H- bb * ( X - (Lastx - DaysBack)); Plot( Close, "Close", colorBlack, styleCandle ); 

Plot( llf( X >= (lastx - Daysback), y, -lelO ), "LInReg", colorRed ); 

SEE ALSO 
References: 


The LinRegSlope function Is used In the following formulas In AFL on-line library: 

• Advanced Trend Lines with S & R 

• AR_Predlctlon.afl 

• ATR Study 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• CCT Kaleidoscope 

• correlerror 

• Dave Landry PullBack Scan 

• ekeko price chart 

• Gabriel Linear Regression Angle Indicator 

• Gann Five Day pullback 

• JEEVAN'SSRI CHAKRA 

• Linear Regression Line w/ Std Deviation Channels 

• Perceptron 

• prakash 

• R-Squared 
• regavg 

• Regression Analysis Line 

• RSIS 

• Trend Analysls_Comentary 

• Trend exploration with multiple timeframes 

• Trend Exploration: Slope Moving Average 

• Trigonometric Fit - TrIgFIt with AR for cos / sin 

• Visualization of stoploses and profit In chart 

More information: 


Updated on-line reference 


LinRegSlope - linear regression slope 
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LinRegSlope - linear regression slope 
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Lowest/Highest 


LLV 

- lowest low value 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


llv( ARRAY, periods) 

ARRAY 

Calculates the lowest value In the ARRAY over the preceding periods (periods Includes the 
current day). The function accepts periods parameter that can be constant as well as 
time-variant (array). 

The formula "llv( close, 14 )" returns the lowest closing price over the preceding 14 periods. 
The hhv() function (see Highest High Value ). 


The LLV function Is used In the following formulas In AFL on-line library: 

• Pivots And Prices And Swing Volume 

• % B of Bollinger Bands With Adaptive Zones 

• 10-20 Indicator 

• 30 Week HI Indicator - Calculate 

• 52 Week New High-New Low Index 

• Adaptave Zones 0/B & 0/S Oscillator 

• Adaptive Price Channel 

• Advanced MA system 

• Advisory NRx price chart display. 

• Against all odds 

• AJDX system 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• An n bar Reversal Indicator 

• Another Fib Level 

• Aroon 

• AR_Predlctlon.afl 

• ATR Study 

• Auto Trader Basic Flow 

• Auto-Optimizatlon Framework 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Awsome Oscllator 

• babaloo chapora 

• Brian Wild 

• Bull Fear / Bear Fear 

• Bullish Percent Index 2 files combined 

• Bullish Percent Index 2004 

• CAMSLIM Cup and Handle Pattern AFL 

• Candle Stick Demo 

• Candlestick Commentary 

• Candlestick Commentary Modified 


LL V - lowest low value 
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• Candlestick Commentary-modified 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI(20) Divergence Indicator 

• CCT Kaleidoscope 

• CCT StochasticRSI 

• Chaikin Volume Accumulation 

• Chandelier Exit 

• Chandelier Exit or Advanced Trailing Stop 

• Channel/S&R and trendlines 

• Compare Sectors against Tickers 

• Congestions detection 

• CVR-severe filter 

• Dahl Oscillator modified 

• Daily High Low in Advance 

• Dave Landry PullBack Scan 

• Dave Landry Pullbacks 

• Demand Index 

• Demand Index 

• Dinapoli Perferred Stochastic 

• Divergences 

• Donchian Channel 

• Double Smoothed Stochastic from W.Bressert 

• DT Oscillator 

• Ed Seykota's TSP: Support and Resistance 

• Ehlers Fisher Transform 

• Elder safe Zone Long -i- short 

• Elder Triple Screen Trading System 

• ElderSafeZoneStopShort 

• FastStochK FullStochK-D 

• Fisher Centre of Gravity 

• Fisher Cyber Cycle 

• Fisher Oscillator 

• Fisher Relative Vigour Index 

• Fre 

• Frequency distribution of returns 

• Fund Screener 

• Gann level plotter 

• Gann Swing chart v41212 

• Gordon Rose 

• Head & Shoulders Pattern 

• Hilbert Sine Wave Support & Resistance 

• IBD relative strength database ranker 

• Ichimoku Chart 

• Ichimoku charts 

• Ichimoku Kinko Hyo 

• ICHIMOKU SIGNAL TRADER 

• Ichimoku with plot mofified to use cloud function 

• IchimokuBrianVioreIRO 

• IFT of RSI - Multiple TimeFrames 

• Improved NH-NH scan / indicator 

• Index of 30 Wk Highs Vs Lows 


LL V - lowest low value 
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• Inter-market Yield Linear Regression Divergence 

• Intraday Strength 

• JEEVAN'S SRI CHAKRA 

• Kagi Chart 

• Larry William's Volatility Channels 

• MACD commentary 

• MACD indicator display 

• Meu Sistema de Trading - versao 1.0 

• mitalpradip 

• Modified Head & Shoulder Pattern 

• Monthly bar chart 

• MS Darvas Box with Exploration 

• Multicycle 1.0 

• Multiple Ribbon Demo 

• Murrey Math Price Lines 

• N-period candlesticks (time compression) 

• nikhil 

• Non-repaitning Zigzag line 

• NR4 Historical Volatility System 

• NRx Exploration 

• P&F Chart - High/Low prices Sept2003 

• P&F chart with range box sizes 

• Pattern - Rectangle Base Breakout on High Vol 

• Pattern_-_Rectangle_Base_Bi'eakout_on_High_Vol 2 

• Peterson 

• PF Chart - Close - April 2004 

• Pivot Finder 

• Pivots And Prices 

• Point & figure Chart India Securities 

• prakash 

• Prashanth 

• Price with Woodies Pivots 

• Probability Density & Gaussian Distribution 

• Pullback System No. 1 

• PVT Trend Decider 

• Rainbow Oscillator 

• Rea Time Daily Price Levels 

• Regression Analysis Line 

• Relative Strength Index 

• RSI Double-Bottom 

• RSI Pointer 

• RSIS 

• RUTVOL timing signal with BB Scoring routine 

• Sainath Sidgiddi 

• Scan New High and New Low 

• shailu lunia 

• Sony 

• Steve Woods' Cum. Vol. Float + Cum. Vol. Channels 

• Stochastic %J - KDJ 

• Stochastic Centre of Gravity 

• Stochastic Cyber Cycle 

• Stochastic Divergence, positive 


LL V - lowest low value 
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• Stochastic Divergences, PDi, NDi 

• Stochastic Fast%K and Fuii 

• Stochastic OBV and Price Fiiter 

• Stochastic Reiative Vigour index 

• Stochastic RSi 

• Stop-ioss indicator bands 

• Stops impiementation in AFS 

• Stress with SuperSmoother 

• Sun&Cioud 

• Support and Resistance 

• Support Resistance ieveis 

• TD Moving Average i 

• TD sequentiai 

• TD Sequentiai 

• The Stochastic CCi 

• Three Day Baiance Point 

• Trend Expioration: Count Number of New Fiighs 

• Trend Trigger Factor 

• Triangie expioration using P&F Chart 

• Triangie search 

• Triangie Search Extended 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• VaiueChart 

• Verticai Fiorizontai Fiiter 

• Verticai Fiorizontai Fiiter (VFiF) 

• Voiatiiity System 

• Weekiy chart 

• Weinberg's The Range indicator 

• Woodie's CCi Panei Basic 

• Woodie's CCi Panei Fuii Stats 

• Woodie's Price Panei With Woodie's Pivots 

• Zig Zag 

• ZLEMA ATR Long Oniy Trading System 
More information: 

Updated on-iine reference 


LLV- lowest low value 
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LLVBars Lowest/Highest 

- bars since lowest low 


SYNTAX LLVBars( ARRAY, periods) 
RETURNS ARRAY 


FUNCTION Calculates the number of periods that have passed since the ARRAY reached Its periods 
period trough. The function accepts periods parameter that can be constant as well as 
time-variant (array). 

EXAMPLE The formula "llvbars( close,50 )" returns the number of periods that have passed since the 

closing price reached Its 50 period trough. 

SEE ALSO 

References: 


The LLVBars function Is used In the following formulas In AFL on-line library: 

• Advanced MA system 

• Aroon Indicators 

• Aroon The Advisor 

• babaloo chapora 

• CAMSLIM Cup and Handle Pattern AFL 

• CCI(20) Divergence Indicator 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Divergences 

• ekeko price chart 

• Fre 

• Fund Screener 

• Gordon Rose 

• Linear Regression Line & Bands 

• Pivot Finder 

• shallu lunia 

• Stochastic Divergence, positive 

• Stochastic Divergences, PDI, NDI 

• Triangle search 

• Triangle Search Extended 

• VIvek Jain 


More information: 

Updated on-line reference 


LLVBars - bars since lowest low 
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- natural logarithm 


AmiBroker Formuia Language (AFL) 

Math functions 


SYNTAX log( NUMBER) 
log( ARRAY) 

RETURNS NUMBER 
ARRAY 

FUNCTION Calculates the natural logarithm of NUMBER or ARRAY. 

EXAMPLE 

SEE ALSO exp() Exponential function 

Comments: 


Tomasz Janeczko 

The synonym to 'log' Is 'In' function. 

2006-03-02 04:26:40 



References: 


The log function Is used In the following formulas In AFL on-line library: 

• Andrews Pitchfork 

• Andrews PltchforkV3.3 

• AR_Predlctlon.afl 

• CAMSLIM Cup and Handle Pattern AFL 

• Dave Landry PullBack Scan 

• Ehler's filters and Indicators 

• Ehlers Fisher Transform 

• Elder Triple Screen Trading System 

• Fisher Centre of Gravity 

• Fisher Cyber Cycle 

• Fisher Oscillator 

• Fisher Relative Vigour Index 

• Frequency distribution of returns 

• Historical Volotlllty Scan - 6/100 

• Historical Volotlllty Scan - 50 Day 

• Hurst Constant 

• IFT of RSI - Multiple TImeFrames 

• Multicycle 1.0 

• NR4 Historical Volatility System 

• NRx Exploration 

• Probability Calculator 

• Schiff Lines 

• Signal to Noise 

• Sony 

• Trigonometric Fit - TrIgFIt with AR for cos / sin 

• Volume Occllator 

• Volume Oscillator 

• ZIg Zag 


iog - naturai iogarithm 
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More information: 

Updated on-line reference 


log- natural logarithm 
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Iog10 

- decimal logarithm 

SYNTAX Iog10( NUMBER) 

Iog10( ARRAY) 

RETURNS NUMBER 

ARRAY 

FUNCTION Calculates the decimal logarithm of NUMBER or ARRAY. 

EXAMPLE 

SEE ALSO 
References: 

The logic function Is used In the following formulas In AFL on-line library: 

• AR_Predlctlon.afl 

• Bad Tick Trim on 5 sec database 

• Cycle Period 

• Trigonometric Fit - TrIgFIt with AR for cos / sin 

More Information: 

Updated on-line reference 


AmiBroker Formuia Language (AFL) 

Math functions 


iog10 - decimai iogarithm 
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Lookup 

- search the array for bar with specified date/time 


Date/Time 

(AFL 3.40) 


SYNTAX Lookup( array, datetime, mode = 0 ) 

RETURNS NUMBER 

FUNCTION The function searches for the bar with specified datetime and returns the vaiue from the 
same position of the input array. 

Parameter 'mode' decides how search is performed in case when exact match is not found: 


• mode = 0 - find exact match, otherwise return Nuil 

• mode = -1 - find exact match, otherwise return nearest predecesor (if datetime is 
past iast bar it wiil return iast bar value) 

• mode = -2 - find exact match, otherwise return nearest predecessor EXCEPT the 
very last bar (if searched datetime is past last bar it will return Null) 

• mode = 1 - find exact match, otherwise return nearest successor (if datetime is 
before first bar it will return first bar value) 

• mode = 2 - find exact match, otherwise return nearest successor EXCEPT the very 
first bar (if searched datetime is before first bar it will return Null) 

This function uses very fast binary search and it is many times faster than previous 
AFL-based methods such as FindValueAtDateTime() presented in the past. Any call to 
FindValueAtDateTime (input, dt, value ) can be now replaced with Lookup( input, value ) 
(here is no need to pass dt- datetime). 

NOTE: This function does not affect QuickAFL required bars, therefore it will only search 
bars that are actually loaded in arrays. For indicators it may mean that it won't be able to find 
value if it is invisible, unless you use SetBarsRequired() function to ensure that more bars 
are loaded. 

EXAMPLE InputDate = "2011-04-05"; 

Title = "Cl ose value at (or before) " + InputDate + " is " + Lookup ( 
Close, _DT ( InputDate ) , -I ) ; 

SEE ALSO DateTimeO function , StrToDateTimeQ function , _DT() function 

References: 


The Lookup function is used in the following formulas in AFL on-line library: 
• GFX ToolTip 

More information: 


Updated on-line reference 


Lookup - search the array for bar with specified date/time 
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Lowest Lowest/Highest 

- lowest value 


SYNTAX Lowest( ARRAY) 
RETURNS ARRAY 


FUNCTION Calculates the highest value In the ARRAY since the first day/bar present In the database. 

EXAMPLE The formula lowest ( rsi(l4) ); returns the lowest Relative Strength Index value ; 

lowest ( close ) returns the lowest closing price. 

SEE ALSO HHV() function , LLV() function , HIGHEST() function 

References: 


The Lowest function Is used In the following formulas In AFL on-line library: 

• AR_Predlctlon.afl 

• Candle Stick Analysis 

• Candle Stick Demo 

• CVR-severe filter 

• Multiple sinus noised 

• Perceptron 

• Triangle exploration using P&F Chart 

• Trigonometric Fit - TrIgFIt with AR for cos / sin 

More information: 


Updated on-line reference 


Lowest - lowest value 


846 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


LowestBars Lowest/Highest 

- bars since lowest 


SYNTAX 

LowestBars( ARRAY) 

RETURNS 

ARRAY 

FUNCTiON 

Calculates the number of periods that have passed since the ARRAYS lowest value. 

EXAMPLE 

The formula"lowestbars( close )" returns the number of periods that have passed since the 
closing price reached its lowest point. 

SEE ALSO 


References: 



The LowestBars function is used in the foilowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 


LowestBars - bars since lowest 
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LowestSince 

- lowest value since condition met 


Lowest/Highest 

(AFL 1.4) 


SYNTAX LowestSince( EXPRESSION, ARRAY, Nth=^} 

RETURNS ARRAY 

FUNCTION Returns the lowest ARRAY value since EXPRESSION was true on the Nth most recent 
occurrence. 


EXAMPLE lowestslnce( Cross( macd(), 0 ), Close, 1 ) returns the lowest close price since macd() has 
crossed above zero. 


SEE ALSO 
References: 


The LowestSince function Is used In the following formulas In AFL on-line library: 

• Gann Swing Chart 

• Gann Swing Charts In 3 modes with text 

• Last Five Trades Result Dashboard - AFL code 

• Market Profile 

• MO_CrashZone 

• RSI of Weekly Price Array 

• Stochastic of Weekly Price Array 

• Time Frame Weekly Bars 

• Visible Min and Max Value Demo 


More information: 

Updated on-line reference 


LowestSince - lowest value since condition met 
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LowestSinceBars 

- barssince lowest value since condition met 


Lowest/Highest 

(AFL 1.4) 


SYNTAX LowestSinceBars( EXPRESSION, ARRAY, Nth=^} 

RETURNS ARRAY 

FUNCTION Returns the number of bars that have passed since lowest ARRAY value since 
EXPRESSION was true on the Nth most recent occurrence. 


EXAMPLE lowestsincebars( Cross( macd(), 0 ), Close, 1 ) returns the number of bars passed since the 
lowest close price was detected from the time when macd() has crossed above zero. 


SEE ALSO 
References: 


The LowestSinceBars function is used in the following formulas in AFL on-line library: 

More Information: 

Updated on-line reference 


LowestSinceBars - barssince lowest value since condition met 
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LowestVisibleValue 

- get the lowest value within visible chart area 


Indicators 

(AFL 3.30) 


SYNTAX LowestVisibleValue( array) 

RETURNS NUMBER 

FUNCTION The function calculates single value (not array) representing lowest value of given array 
within VISIBLE range (on chart). 

Should be applied only in indicators as only indicators have concept of "visible" bars. The 
function will return Null value if no visible bars are present. The function is equivalent to the 
following coding: 


function LowestVisibleValueEquivalent( array ) 

{ 

bv = Status ( "barvisible" ); 

11 = leS; 

for ( 1=0; i < BarCount; i++ ) 

{ 

if ( bv[ i ] AND array[ 1 ] < 11 ) 11 = array[ i ]; 

} 

return 11 ; 


EXAMPLE 

SEE ALSO HighestVisibleValueO function 

References: 


The LowestVisibleValue function is used in the following formulas in AFL on-line library: 

• Fre 

• Volume Charts 


More Information: 

Updated on-line reference 


LowestVisibleValue - get the lowest value within visible chart area 
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Moving averages, summation 


MA 

- simple moving average 


SYNTAX ma( ARRAY, periods) 

RETURNS ARRAY 

FUNCTiON Calculates a periods simple moving average of ARRAY The function accepts periods 
parameter that can be constant as well as time-variant (array). 


EXAMPLE ma(CLOSE, 5 ) 

SEE ALSO TEMA() function , AMA() function , AMA2() function , DEMAQ function , WMA() function , 
WILDERSO function , EMA() function 

References: 


The MA function Is used In the following formulas In AFL on-line library: 

• % B of Bollinger Bands With Adaptive Zones 

• 'R' Channel 

• AC-i- acceleration 

• accum/dlst mov avg crossover SAR 

• AccuT rack 

• Advanced MA system 

• Adverse Move Ratio 

• ADXbuy 

• AFL Example 

• AFL Example - Enhanced 

• AFL to Python COM Link 

• AFL-Excel 

• Against all odds 

• ALJEHANI 

• Andrews PltchforkV3.3 

• AOh- Momentum Indicator 

• AO-i-Momentum 

• Application of Ehler filter 

• Arnaud Legoux Moving Average (ALMA) 

• AR_Predlctlon.afl 

• ATR Study 

• Auto Trader Basic Flow 

• Auto-Optimizatlon Framework 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• automatic trendlines using fractal patterns 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Dollar Price Volatility Exploration 

• Average Price Crossover 

• Awsome Oscllator 

• babaloo chapora 

• Bad Tick Trim on 5 sec database 


MA - simple moving average 
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• Balance of Power 

• balance of power 

• BB squeeze 

• Better Bollinger Bands 

• Bman's HaDIffCO 

• BMTRIX Intermediate Term Market Trend Indicator 

• Bollinger - Keltner Bands 

• Bollinger band normalization 

• Bollinger Fibonacci Bands 

• Bollinger oscillator 

• Bottom Fisher Exploration 

• Bow tie 

• Breadth Thrust 

• Bull/Bear Volume 

• Bullish Percent Index 2 files combined 

• CAMSLIM Cup and Handle Pattern AFL 

• Candle Identification 

• Candle Pattern Function 

• Candle Stick Analysis 

• candlestick chart for Volume/RSI/OBV 

• Candlestick Volume Bars with Moving Average 

• CandleStochastIcs 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI Woodies Style 

• CCI/DI+- COMBO Indicator 

• CCT Bollinger Band Oscillator 

• CCT FIbAccordlon 

• CCT Kaleidoscope 

• Chaikin's Volatility 

• Chande Momentum Oscillator 

• Chande's Trend Score 

• Chandelier Exit 

• Chandelier Exit 

• Chandelier Exit or Advanced Trailing Stop 

• changing period moving average 

• CoInToss ver 1 

• Color Price Bar - Impulse System 

• com-out 

• COMBO 

• Commodity Selection Index (CSI) 

• Compare Sectors against Tickers 

• Composite Index 

• Congestions detection 

• Connors TPS 

• Continuous Contract Rollover 

• Coppock Curve 

• Coppock Histogram 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• correlerror 

• crMathLIb 


MA - simple moving average 
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• CVR-severe filter 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Dahl Oscillator modified 

• Daily High Low in Advance 

• danningham penetration 

• Dave Landry PullBack Scan 

• Dave Landry Pullbacks 

• DEBAJ 

• Demand Index 

• Demand Index 

• Derivative Oscillator 

• DiNapoli Detrended Oscillator 

• DiNapolis 3x Displaced Moving Averages 

• Divergences 

• DMI Spread Index 

• Dominant Cycle Phase 

• Double Smoothed Stochastic from W.Bressert 

• DPO with shading 

• DT Oscillator 

• Dynamic Momentum Index 

• Dynamic Momentum Index 

• Dynamtic Momentum Index 

• Effective Swing Indicator 

• ekeko price chart 

• Elder Bear Power 

• Elder Bull Power 

• Elder Impulse Indicator 

• Elder Impulse Indicator V2 

• Elder Ray - Bull Bear 

• Elder Ray Oscillator with MA 

• Elder Triple Screen Trading System 

• Elder's Market Thermometer 

• Elliott Wave Oscillator 

• Ema bands 

• EMA Crossover 

• EMA Crossover Price 

• Envelope System 

• Ergodic Oscillator 

• FastStochK FullStochK-D 

• Fibonacci Moving averages 

• fishnet 

• Follow the Leader 

• Force index 

• Fund Screener 

• Future MA Projection 

• Futures - Dollar Move Today Indicator 

• Gabriel Linear Regression Angle Indicator 

• Gann Five Day pullback 

• Gann HiLo Indicator and System 

• Gann Swing chart v41212 

• Gann Swing Charts in 3 modes with text 


MA - simple moving average 
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• garythompson 

• garythompson 

• Gordon Rose 

• Guppy moving averages 

• Heatmap V1 

• Heikin Ashi Candles 

• Heikin Ashi Delta 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• Heinkin-Ashi 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• Hilbert Study 

• HLspread 

• Hull Moving Average 

• Hull Multiple Moving Averages 

• Hull with DEMA 

• Hurst "Like" DE 

• ICHIMOKU SIGNAL TRADER 

• IFT of RSI - Multiple TimeFrames 

• Index and FTP trading 

• Inter-market Yield Linear Regression Divergence 

• INTRADAY HEIKIN ASHI new 

• IntraDay Open Marker 

• Intraday Volume EMA 

• Inverted Plotted Volume Overlay Indicator 

• JEEVAN'S SRI CHAKRA 

• John Ehler 

• Kairi Relative Index 

• Kelly criterion 

• Keltner Channel 

• Know Sure Thing 

• Lagging MA-Xover 

• MA Difference 20 Period 

• MACD Histogram - Change in Direction 

• Main price chart with Rainbow & SAR 

• MAM 

• Market Direction 

• McClellan Oscillator 

• McClellan Summation Index 

• Meu Sistema de Trading - versao 1.0 

• mfimacd 

• MOCS 

• Modified Head & Shoulder Pattern 

• Modified-DVI 

• Momentum 

• Momentum 

• Moving Average "Crash" Test 

• Moving Averages NoX 

• MS Darvas Box with Exploration 

• Multicycle 1.0 

• Multiple Ribbon Demo 


MA - simple moving average 
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• NASDAQ 100 Volume 

• Neural Network Powered Smooth/PredIctIve RSI V2 

• nikhll 

• NoorDoodle 

• Parametric Chande Trendscore 

• Pattern - Rectangle Base Breakout on High Vol 

• Pattern_-_Rectangle_Base_Breakout_on_Hlgh_Vol 2 

• Percentage Price Oscillator 

• Perceptron 

• Peterson 

• Pivots for Intraday Forex Charts 

• Plot the Equity Curve without Backtesting? 

• Polarized Fractal Efficiency 

• prakash 

• Price with Woodies Pivots 

• Price-Volume Rank 

• Probability Density & Gaussian Distribution 

• Projection Oscillator 

• Pullback System No. 1 

• QP2 Float Analysis 

• QStIck 

• Rainbow Charts 

• Rainbow Oscillator 

• Random Walk Index 

• Random Walk Index, base formula Included 

• Rapid Prototyping Method for System Development 

• regavg 

• Relative Strength 

• Relative strength comparison with moving average 

• Reverse EMA function 

• RSI -I- Avgs 

• RSI Double-Bottom 

• RSI Pointer 

• RSIS 

• RUTVOL timing signal with BB Scoring routine 

• Salnath SIdgIddI 

• Scale Out: Futures 

• Schiff Lines 

• Sector Tracking 

• SectorRSI 

• SF Entry,Stop, PT Indicator 

• shallu lunia 

• Signal to Noise 

• SIROC Momentum 

• STARC Bands 

• STD_STK Multi 

• STO & MACD Buy Signals with Money-Management 

• Stochastic %J - KDJ 

• Stochastic Fast%K and Full 

• Stochastic of Weekly Price Array 

• Stochastic RSI 

• StochD_StochK Single.afl 


MA - simple moving average 
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• Stops on percentages 

• Sun&Cloud 

• Support and Resistance 

• Support Resistance ieveis 

• T3 

• T3 Function 

• TAZ Trading Method Exploration 

• TD Channel-1 

• TD Channel-2 

• TD Moving Average 2 

• TD Moving Average I 

• testing multiple system simulataneously 

• The D_oscillator 

• The Mean RSIt (variations) 

• The Relative Slope 

• The Relative Slope Pivots 

• The Saturation Indicator D_sat 

• tomy_frenchy 

• Trend Detection 

• Trend exploration with multiple timeframes 

• Trend Exploration: Slope Moving Average 

• TRENDAdvisor 

• Triangle exploration using P&F Chart 

• Triangle search 

• Triangle Search Extended 

• Triangular Moving Average 

• Triangular Moving Average new 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• TRIX 

• TRIXXX 

• TTM Squeeze 

• Tushar Chande's Projected Range 

• ValueChart 

• VAMA 

• Varexiist 

• Vertical Horizontal Filter (VHF) 

• Vic Huebner 

• Vikram's Floor Pivot Intraday System 

• Visualization of stoploses and profit in chart 

• Vivek Jain 

• Volatility 

• Volatility Breakout with Bollinger Bands 

• Volatility Quality Index 

• Volume - compared with Moving Avg (100%) 

• Volume Color with Dynamic Limit 

• Volume Occilator 

• Volume Oscillator 

• Weekly Trend in Daily Graph 

• Weinberg's The Range Indicator 

• William's Alligator System II 

• Williams Alligator system 

• WILSON RELATIVE PRICE CHANNEL 


MA - simple moving average 
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• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Heikin-Ashi Panel 

• Woodie's Price Panel With Woodie's Pivots 

• z-distance from vwap 

• Z-Score Indicator 

• ZeroLag MACD(p,q,r) 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


MA- simple moving average 
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MACD Indicators 

- moving average convergence/divergence 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


macd(/asf = 12, slow = 26) 

ARRAY 

Calculates the MACD Indicator using /asf and s/owaveraging periods. 

The formula "macd()" returns the value of the MACD Indicator (I.e., the red line). The formula 
"sIgnalO" returns the value of the MACD's signal line (I.e., the blue line). 

The sIgnalO function. 


The MACD function Is used In the following formulas In AFL on-line library: 

• Adaptave Zones 0/B & 0/S Oscillator 

• AFL Example - Enhanced 

• ALJEHANI 

• Bollinger band normalization 

• Button trading using AB auto trading Interface 

• Color MACD Histogram Changes 

• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• Compare Sectors against Tickers 

• Customised Avg. Profit %, Avg. Loss % etc 

• DInapoll Guru Commentary 

• ekeko price chart 

• Elder Impulse Indicator 

• Elder Impulse Indicator V2 

• Elder Triple Screen Trading System 

• Fund Screener 

• hassan 

• ICHIMOKU SIGNAL TRADER 

• Indicator Explorer (ZIgZag) 

• Last Five Trades Result Dashboard - AFL code 

• MACD commentary 

• MACD Histogram - Change In Direction 

• MACD Indicator display 

• MACD optimize 

• Meu SIstema de Trading - versao 1.0 

• STO & MACD Buy Signals with Money-Management 

• swing chart 

• The Mean RSIt 

• The Mean RSIt (variations) 

• Trend Analysls_Comentary 

• Trending or Trading ? 

• Trending Ribbon 

• TrendIngRIbbonArrowsADX 

• VIvek Jain 

• ZeroLag MACD(p,q,r) 


MACD - moving average convergence/divergence 
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More information: 

Updated on-line reference 


MACD- moving average convergence/divergence 
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MarketID information / Categories 

- market ID / name (AFL 1 8) 


SYNTAX MarketlD( mode = 0 ) 

RETURNS NUMBER/STRING 

FUNCTION Retrieves current stock market ID/name When mode = 0 (the default value ) this function 
returns numerical marketID (consecutive market number) 

When mode = 1 this function returns name of the market. 

EXAMPLE Filter = MarketlD() == 7 OR MarketlD() == 9; 

AddTextColumn( MarketlD( 1 ), "Market name"); 

SEE ALSO 
References: 


The MarketID function is used in the following formulas in AFL on-line library: 

• Alert Output As Quick Rewiev 

• Auto-Optimization Framework 

• Compare Sectors against Tickers 

• Dave Landry PullBack Scan 

• Elder Triple Screen Trading System 

More information: 

Updated on-line reference 


MarketID - market ID / name 
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Matrix 

- create a new matrix 


Matrix functions 

(AFL 4.0) 


SYNTAX Matrix( rows, cois, initvaiue) 

RETURNS Matrix 

FUNCTiON The function creates a new matrix of user specified dimensions with aii eiements fiiied with 
initvaiue. 

To create a matrix use 

my_var_name = Matrix( rows, cols, initvaiue) 

To access matrix elements, use: 
my_var_name[ row ][ col ] 
where 

row is a row index (0... number of rows-1) 
and 

col is a column index (0... number of columns-1) 

Matrices and their elements support all scalar (element-wise) arithmetic and logical 
operations 

So you can for example add, subtract, multiply, divide two matrices if they have same 
dimensions with one call. 

EXAMPLE 

X = Matrix ( 5, 6, 9 ); // matrix 5 rows 6 columns, initial value 9 

y = Matrix ( 5, 6, 10 ); // matrix 5 rows 6 columns, initial value 10 

z = y - z; // will give you matrix 5 rows and 6 columns filled with 
elements holding value 1 (difference between 10 and 9). 

SEE ALSO 
References: 

The Matrix function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


Matrix - create a new matrix 
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Max Math functions 

- maximum value of two numbers / arrays 


SYNTAX Max( ARRAY1, ARRAY2 ) 

RETURNS ARRAY 

FUNCTION Returns the largest of the two parameters. 

EXAMPLE The formula "max( CLOSE, 10 )" returns either the closing price or 10, whichever Is greater. 
The formula "max(-14, 13)" always returns 13. 

SEE ALSO 
References: 


The Max function Is used In the following formulas In AFL on-line library: 

• 'R' Channel 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Advanced MA system 

• AFL_Glossary_Converter 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• AR_Predlctlon.afl 

• ATR Study 

• Auto-Optimizatlon Framework 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• AutoTrade using an Exploration 

• Bad Tick Trim on 5 sec database 

• Bman's HaDIffCO 

• Bullish Percent Index 2 files combined 

• Bullish Percent Index 2004 

• candlestick chart for Volume/RSI/OBV 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI(20) Divergence Indicator 

• Channel/S&R and trendlines 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• correlerror 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Cycle Period 

• Dominant Cycle Phase 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• Ehler's filters and Indicators 


Max - maximum value of two numbers / arrays 
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• EMA Crossover 

• Fisher Oscillator 

• Gann Swing Charts in 3 modes with text 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Flarmonic Patterns 

• Fleatmap V1 

• Fleikin Ashi Candles 

• Fleikin Ashi Delta 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• Heinkin-Ashi 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• HLspread 

• interactively test discretionary trading 

• INTRADAY HEIKIN ASHI new 

• JEEVAN'S SRI CHAKRA 

• John Ehler 

• Kiss and Touch with the Modified True Range 

• MACD indicator display 

• Market Breadth Chart-In-Chart 

• mitalpradip 

• MO_CrashZone 

• P&F Chart - High/Low prices Sept2003 

• P&F chart with range box sizes 

• Parabolic SAR in VBScript 

• Performance Check 

• PF Chart - Close - April 2004 

• Pivots for Intraday Forex Charts 

• Probability Density & Gaussian Distribution 

• Projection Oscillator 

• PVT Trend Decider 

• Rainbow Oscillator 

• Random Walk Index, base formula included 

• Rebalancing Backtest avoiding leverage 

• Renko Chart 

• Scale Out: Futures 

• shailu lunia 

• Signal to Noise 

• Stops Implementation in AFS 

• Stops on percentages 

• Three Line Break - TLB 

• Trailing Stop Loss 

• Trend Detection 

• Trend Following System 

• Trend Lines from 2 points 

• Triangle exploration using P&F Chart 

• Triangle Search Extended 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Twiggs Money Flow 


Max - maximum value of two numbers / arrays 
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• Twiggs money flow weekly 

• Vikram's Floor Pivot Intraday System 

• VSTOP (2) 

• VSTOP (3) 

• William's Alligator System II 

• Woodie's CCI Panel Full Stats 

• Woodie's Heikin-Ashi Panel 

• Zig Zag 

More information: 

Updated on-line reference 


Max- maximum value of two numbers / arrays 
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MDI 

- minus directional movement indicator (-DI) 


SYNTAX mdi( period = 14) 

RETURNS ARRAY 

FUNCTION Calculates Minus Directional Movement Indicator (-DI line) 

EXAMPLE mdl() 

SEE ALSO 
References: 


The MDI function Is used In the following formulas In AFL on-line library: 

• ADX Indicator - Colored 

• ADXbuy 

• AJDX system 

• babaloo chapora 

• CCI/Dk- COMBO Indicator 

• Commodity Selection Index (CSI) 

• Dave Landry Pullbacks 

• DMI Spread Index 

• ekeko price chart 

• Heatmap V1 

• ICHIMOKU SIGNAL TRADER 

• Index and ETF trading 

• Mndahoo ADX 

• Multiple Ribbon Demo 

• swing chart 

• The Three Day Reversal 

• Trend Analysls_Comentary 

• Trending Ribbon 

• TrendIngRIbbonArrowsADX 

• VIvek Jain 


More information: 


Updated on-line reference 


indicators 

(AFL 1.3) 


MDI - minus directional movement indicator (-DI) 
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Median 

- calculate median (middle element) 


Statistical functions 

(AFL 2.5) 


SYNTAX Median( array, period) 
RETURNS ARRAY 


FUNCTION The Median function - finds median (middie eiement) vaiue of the array over period 

eiements. Note that LOWER median is returned when 'period' is an even number. If you want 
to get average of upper and iower median for even 'periods' you need to use Percentiie( 
array, period, 50 ) instead. It will do the averaging for you but runs slower. 


EXAMPLE // list only symbols which volume is greater than 
// median Volume from past 50 days 

Filter = Volume > Median ( Volvime, 50 ); 

AddColumn ( V, "Volume" ); 


SEE ALSO PercentileO function 

References: 


The Median function is used in the following formulas in AFL on-line library: 

• Adaptive Laguerre Filter, from John Ehlers 

• AR_Prediction.afl 

• Bad Tick Trim on 5 sec database 

• Cycle Period 

• Elder's Market Thermometer 

• NoorDoodie 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Zig Zag 

More information: 


Updated on-line reference 


Median - calculate median (middle element) 
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- money flow index 


SYNTAX 

mfi( periods = 14 ) 

RETURNS 

ARRAY 

FUNCTION 

Calculates the Money Flow Index with period range 

EXAMPLE 

mfi( 16 ) 

SEE ALSO 

The rsi() function (see Relative Strength Index (RSI)) 

References: 



The MFI function is used in the foilowing formulas in AFL on-line library: 

• Adaptave Zones 0/B & 0/S Oscillator 

• Against all odds 

• Bollinger band normalization 

• DateNumDateStr 

• ICHIMOKU SIGNAL TRADER 

• Market Facilitation Index VS Volume 

• mfimacd 

• Ranking Ticker WatchList 

• Reverse MFI Crossover 

• Volatility Breakout with Bollinger Bands 

More information: 

Updated on-line reference 


AmiBroker Formuia Language (AFL) 

Indicators 


MFI - money flow index 
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MicroSec Date/Time 

- get bar's microsecond part of the timestamp 


SYNTAX 

MicroSecO 

RETURNS 

ARRAY 

FUNCTiON 

get bar's microsecond part of the timestamp (0..999) 

EXAMPLE 

The function will return zero if data source does not support sub-second resolution 

Title = StrFormat ( "Timestamp is = 

%02 . Of : %02 . Of : %02 . Of . %03 . Of %03 . Of " , Hour(), MinuteO, SecondO, 
MilliSecO, MicroSecO ); 

SEE ALSO 

HOUR() function , MINUTEQ function , SECOND() function , MilliSec() function 

References: 



The MicroSec function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-line reference 


MicroSec - get bar's microsecond part of the timestamp 
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MilliSec Date/Time 

- get bar's millisecond part of the timestamp 


SYNTAX 

MilliSecQ 

RETURNS 

ARRAY 

FUNCTION 

get bar's millisecond part of the timestamp (0..999) 

EXAMPLE 

The function will return zero if data source does not support sub-second resolution 

Title = StrFormat ( "Timestamp is = 

%02 . Of : %02 . Of : %02 . Of . %03 . Of %03 . Of " , Hour(), MinuteO, SecondO, 
MilliSec 0, MicroSecO ); 

SEE ALSO 

HOUR() function , MINUTEQ function , SECOND() function , MicroSec()() function 

References: 



The MilliSec function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-line reference 


MilliSec - get bar's millisecond part of the timestamp 
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Math functions 


Min 

- minimum value of two numbers / arrays 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


Min( ARRAY1, ARRAY2) 

ARRAY 

Returns the smallest of the two parameters. 

The formula "mln( CLOSE, 10 )" returns the closing price or 10, whichever Is less. The 
formula "mln(-14, 13)" always returns -14. 

The max() function. 


The Min function Is used In the following formulas In AFL on-line library: 

• 'R' Channel 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Advanced MA system 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• Andrews Pitchfork 

• Andrews PltchforkV3.3 

• AR_Predlctlon.afl 

• ATR Study 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• AutoTrade using an Exploration 

• Bad Tick Trim on 5 sec database 

• Bman's HaDIffCO 

• Bullish Percent Index 2 files combined 

• Bullish Percent Index 2004 

• candlestick chart for Volume/RSI/OBV 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI(20) Divergence Indicator 

• Channel/S&R and trendlines 

• correlerror 

• CVR-severe filter 

• Cycle Period 

• Demand Index 

• Dominant Cycle Phase 

• Ed Seykota's TSP: Support and Resistance 

• Elder Impulse Indicator V2 

• EMA Crossover 

• Fibonacci Internal and External Retracements 

• Fisher Oscillator 

• Gann Swing Charts In 3 modes with text 


Min - minimum value of two numbers / arrays 
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• Graphical sector stock amalysis 

• Harmonic Patterns 

• Heatmap V1 

• Heikin Ashi Candles 

• Heikin Ashi Delta 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• Heinkin-Ashi 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• HLspread 

• interactively test discretionary trading 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 

• JEEVAN'S SRI CHAKRA 

• John Ehler 

• MACD commentary 

• mitalpradip 

• MO_CrashZone 

• Multicycle 1.0 

• P&F Chart - High/Low prices Sept2003 

• P&F chart with range box sizes 

• Parabolic SAR in VBScript 

• Parametric Chande Trendscore 

• Performance Check 

• PF Chart - Close - April 2004 

• Pivots for Intraday Forex Charts 

• Probability Density & Gaussian Distribution 

• Projection Oscillator 

• PVT Trend Decider 

• Rainbow Oscillator 

• Relative Strength Index 

• Renko Chart 

• Scale Out: Futures 

• Schiff Lines 

• shailu lunia 

• Signal to Noise 

• Stops Implementation in AFS 

• Stops on percentages 

• Three Line Break - TLB 

• Trend Lines from 2 points 

• Triangle exploration using P&F Chart 

• Triangle Search Extended 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Twiggs Money Flow 

• Twiggs money flow weekly 

• TWS trade plotter 

• Vikram's Floor Pivot Intraday System 

• VSTOP (2) 

• VSTOP (3) 

• Weekly chart 

• Woodie's CCI Panel Full Stats 


Min - minimum value of two numbers / arrays 
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• Woodie's Heikin-Ashi Panel 
More information: 

Updated on-line reference 


Min- minimum value of two numbers / arrays 
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Minute 

- get current bar's minute 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


MinuteQ 

ARRAY 

Retrieves current bar's minute 
Hour()*10000 + MinuteO * 100 + Second() 
Hour(), SecondO, TimeNumQ 


The Minute function is used in the foilowing formulas in AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• AR_Prediction.afl 

• Buyer Seller Force 

• Export EOD or Intraday to .csv file 

• Export Intraday Data 

• Luna Phase 

• Trigonometric Fit - TrigFit with AR for cos / sin 

More information: 


Updated on-line reference 


Date/Time 

(AFL 2.0) 


Minute - get current bar's minute 
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Date/Time 

(AFL 1.4) 


SYNTAX 

MonthQ 

RETURNS 

ARRAY 

FUNCTiON 

Returns the array with months(1-12) 

EXAMPLE 

buy = ( monthQ == 1 ) and day < 3; // buy in January 

SEE ALSO 


References: 



The Month function is used in the foliowing formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• Auto Trade Step by Step 

• Days to Third Friday 

• Expiry day/days - Last thursday of month 

• Expiry Thursday for Indian markets 

• Export All Daily Data to TXT with MS import format 

• Export EOD or Intraday to .csv file 

• Export Intraday Data 

• Luna Phase 

• Lunar Phases - original 

• LunarPhase 

• Monthly bar chart 

• N-period candlesticks (time compression) 

• Next Date Format 

• Option Calls, Puts and days till third friday. 

• Prashanth 

• Relative Strength Multichart of up to 10 tickers 

• Wolfe Wave Patterns 

More information: 

Updated on-line reference 


Month 
- month 


Month - month 
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mtRandom 

- Mersene Twister random number generator 


Statistical functions 

(AFL 3.0) 


SYNTAX mtRandom( seed = Null) 

mtRandomA( seed = Null) 

RETURNS NUMBER or ARRAY 

FUNCTION mtRandom( seed = Null) - returns single random number (scalar) In the range [0,1) 
mtRandomA( seed = Null) - returns array of random numbers In the range of [0,1) 


seed Is random generator seed value. If you don't specify one, the random number generator 
Is automatically Initialized with current time as a seed that guarantees unique sequence 

Both functions use Mersene Twister mt19973ar-cok algorithm. (Copyright (C) 1997 - 2002, 
Makoto Matsumoto and TakujI NIshImura.) 

Mersene Twister Is vastly superior to C-runtIme pseudo-random generator available via 
RandomO function. 

It has a period of 2^19973 = approx 2.9*10^6012 For more Information visit: 
http://www.math.scl.hlroshlma-u.ac.jp/~m-mat/MT/emt.html 

See also: M. Matsumoto and T. NIshImura, "Mersenne Twister: A 623-Dlmenslonally 
Equidlstrlbuted Uniform Pseudo-Random Number Generator", ACM Transactions on 
Modeling and Computer Simulation, Vol. 8, No. 1, January 1998, pp 3-30. 

EXAMPLE prIntfC'Random number: %g", mtRandomQ ); 

SEE ALSO RANDOMO function 

References: 


The mtRandom function Is used In the following formulas In AFL on-line library: 
• MFE and MAE and plot trades as Indicator 

More information: 


Updated on-line reference 


mtRandom - Mersene Twister random number generator 
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mtRandomA 

- Mersene Twister random number generator (array version) 


Statistical functions 

(AFL 3.0) 


SYNTAX mtRandomA( seed = Null) 

RETURNS ARRAY 

FUNCTION This is array version of mtRandom function 

For more detaiis piease check mtRandom function. 


EXAMPLE 

SEE ALSO mtRandomO function 

References: 

The mtRandomA function is used in the foiiowing formuias in AFL on-iine iibrary: 
• CoinToss ver 1 

More information: 

Updated on-iine reference 


mtRandomA - Mersene Twister random number generator (array version) 
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MxGetSize 

- get size of the matrix 


Matrix functions 

(AFL 4.0) 


SYNTAX MxGetSize( matrix, dim ) 

RETURNS Number 

FUNCTiON The function retrieves the matrix size in given dimension. 


• matrix is the matrix variabie to query for size 

• dim is the dimension to query - 0 means rows, 1 means coiumns 

EXAMPLE my_ _matrix = Matrix ( 9, 3 ); 


rows = MxGetSize( my_matrix, 0 ); 
columns = MxGetSize( my_matrix, 1 ); 


SEE ALSO MatrixO function 

References: 


The MxGetSize function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 


Updated on-line reference 


MxGetSize - get size of the matrix 
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Mxidentity 

- create an identity matrix 


Matrix functions 

(AFL 4.0) 


SYNTAX 

RETURNS 

FUNCTiON 

EXAMPLE 

SEE ALSO 
References: 


Mxidentity( size) 

Matrix 

The function creates an identity matrix of defined size (square matrix with rows and coiumns 
equai to size argument fiiied with ones on the main diagonai and zeros eisewhere). 

m = Mxldentity( 5 ); // create 5x5 identity matrix 

MatrixO function , MxGetSize() function 


The Mxidentity function is used in the foilowing formulas in AFL on-line library: 


More information: 


Updated on-line reference 


Mxidentity - create an identity matrix 
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MxTranspose 

- creates transpose of an input matrix 


Matrix functions 

(AFL 4.0) 


SYNTAX MxTranspose( matrix) 

RETURNS Matrix 

FUNCTiON The function creates a transpose of an input matrix matrix. Transpose of a matrix is a new 
matrix whose rows are the coiumns of the originai. 


EXAMPLE 

SEE ALSO MatrixO function , MxGetSize() function , Mxldentity() function 

References: 


The MxTranspose function is used in the foiiowing formuias in AFL on-line library: 

More information: 


Updated on-line reference 


MxTranspose - creates transpose of an input matrix 
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Name 

- ticker symbol 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


Name() 

STRING 


It is used to display the stock short name (ticker) 
name() 


The Name function is used in the following formulas in AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• 3 Price Break 

• 3TF Candlestick Bar Chart 

• AccuT rack 

• Advanced MA system 

• Advanced Trend Lines with S & R 

• ADX Indicator - Colored 

• AFL Example 

• AFL Example - Enhanced 

• AFL to Python COM Link 

• AFL-Excel 

• AFL_Glossary_3 

• AFL_Glossary_Converter 

• Against all odds 

• Alert Output As Ouick Rewiev 

• ALJEHANI 

• Alpha and Beta and R_Squared Indicator 

• Alternative ZIG type function, multi TF 

• AO-i-Momentum 

• Aroon Indicators 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• Auto-Optimization Framework 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Dollar Price Volatility Exploration 

• Average Price Crossover 

• babaloo chapora 

• Baseline Relative Performance Watchlist charts V2 

• Bollinger - Keltner Bands 

• Bull Fear / Bear Fear 

• Bullish Percent Index 2004 

• Button trading using AB auto trading interface 


Information / Categories 

(AFL 1.1) 


Name - ticker symbol 
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• candlestick chart for Volume/RSI/OBV 

• CCI Woodies Style 

• CCI(20) Divergence Indicator 

• Channel/S&R and trendlines 

• Cole 

• Color Coded Short Term Reversal Signals 

• colored CCI 

• Commodity Channel Index 

• Commodity Selection Index (CSI) 

• Continuous Contract Rollover 

• Coppock Trade Signal on Price Chart 

• Dave Landry PullBack Scan 

• De Mark's Range Projection 

• DEBAJ 

• Dinapoli Guru Commentary 

• DINapolis 3x Displaced Moving Averages 

• Double Smoothed Stochastic from W.Bressert 

• Double top detection 

• DPO with shading 

• Elder Triple Screen Trading System 

• Elder's Market Thermometer 

• Elder's SafeZone Stop 

• ElderSafeZoneStopLong 

• ElderSafeZoneStopShort 

• Elliott Wave Oscillator 

• EMA Crossover Price 

• Export All Daily Data to TXT with MS import format 

• Export EOD or Intraday to .csv file 

• Export Intraday Data 

• FastStochK FullStochK-D 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Ere 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Futures - Dollar Move Indicator 

• Futures - Dollar Move Today Indicator 

• Gann level plotter 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Harmonic Patterns 

• hassan 

• Heikin Ashi Candles 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• Heinkin-Ashi 

• Herman 

• IB Backfiller 

• IBD relative strength database Viewer 

• Improved NH-NH scan / indicator 

• In Watch List 


Name - ticker symbol 
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• Indicator Explorer (ZigZag) 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 

• Intraday Trend Break System 

• JEEVAN'S SRI CHAKRA 

• Larry William's Volatility Channels 

• Last Five Trades Result Dashboard - AFL code 

• MA Difference 20 Period 

• MACD commentary 

• MACD Histogram - Change in Direction 

• Main price chart with Rainbow & SAR 

• Manual Bracket Order Trader 

• Market Facilitation Index VS Volume 

• MFE and MAE and plot trades as indicator 

• mitalpradip 

• Mndahoo ADX 

• Modified-DVI 

• Monthly Coppock Guide 

• Moving Averages NoX 

• MS Darvas Box with Exploration 

• N Line Break Chart 

• Neural Network Powered Smooth/Predictive RSI V2 

• Nick 

• NoorDoodie 

• Now Send Push Notifications From Amibroker 

• Optimal Weights 

• P&F Chart - High/Low prices Sept2003 

• Parabolic SAR in JScript 

• Parabolic SAR in VBScript 

• ParabXO 

• Peterson 

• PF Chart - Close - April 2004 

• Pivot End Of Day Trading System 

• Pivot Finder 

• Pivot Point and Support and Resistance Points 

• Pivots for Intraday Forex Charts 

• Point & figure Chart India Securities 

• Position Sizing and Risk Price Graph 

• Position Sizing and Risk Price Graph - 2 

• prakash 

• Price with Woodies Pivots 

• Probability Calculator 

• PVT Trend Decider 

• OP2 Float Analysis 

• Rainbow Charts 

• Rainbow Oscillator 

• Random Walk Index 

• Ranking Ticker WatchList 

• Rea Time Daily Price Levels 

• Relative Strength 

• Relative Strength Index 

• Rene Rijnaars 


Name - ticker symbol 
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• Renko Chart 

• Rl - Auto Trading System 

• Robert Antony 

• ROC of MACD Weekly 

• RSI indicator with Upper & Lower Zone Bars 

• RSI of Weekly Price Array 

• RSI styleClipMinMax 

• RSIS 

• Scan New High and New Low 

• shailu lunia 

• Shares To Buy Price Graph 

• Simple Momentum 

• STD_STK Multi 

• Steve Woods' Cum. Vol. Float + Cum. Vol. Channels 

• Steve Woods' Cumulative Vol. Percentage Indicator 

• Steve Woods' Float Channel Lines 

• Stochastic Fast%K and Full 

• Stochastics Trendlines 

• StochD_StochK Single.afl 

• Stock price Alertif 

• Stress with SuperSmoother 

• Sun&Cloud 

• Super Trend Indicator 

• Support Resistance levels 

• suresh 

• TD REI 

• TD Sequential 

• The D_oscillator 

• Three Line Break - TLB 

• Trend Exploration: Count Number of New Highs 

• Trend Exploration: Slope Moving Average 

• Triangular Moving Average 

• Triangular Moving Average new 

• TRIX 

• Twiggs Money Flow 

• TWS trade plotter 

• Ultimate plus 

• UltraEdit editor highlight wordfile 

• ValueChart 

• Vikram's Floor Pivot Intraday System 

• Visi-Trade 

• Volume Occilator 

• Weinberg's The Range Indicator 

• William's Alligator System II 

• Woodie's CCI Panel Full Stats 

• Woodie's Heikin-Ashi Panel 

• Woodies CCI 

• Zig Zag Indicator with Valid Entry and Exit Points 

• ZigZag filter rewrited from scratch in AFL 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 


Name - ticker symbol 
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More information: 

Updated on-line reference 


Name- ticker symbol 


884 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


NoteGet 

- retrieves the text of the note 


Miscellaneous functions 

(AFL 2.6) 


SYNTAX NoteGet( "Symbol") 

RETURNS STRING 

FUNCTION Retrieves note linked to "symbol". If symbol is "" (empty string) then current symbol is used. 
If symbol is "" (empty string) then current symbol is used. 


EXAMPLE "You have entered the following text in the notepad" + NoteGet 

SEE ALSO NoteSetO function 

References: 


The NoteGet function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


NoteGet - retrieves the text of the note 
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NoteSet 

- sets text of the note 


Miscellaneous functions 

(AFL 2.6) 


SYNTAX NoteSet( "Symbol", "Text.." ); 

RETURNS NUMBER 

FUNCTION Sets text of the note linked to "symbol". 

If symbol is "" (empty string) then current symbol is used. 

If you overwrite note from AFL level that is opened at the same time in Notepad editor the 
editor will ask you (when you switch the focus to it) if it should reload new text or allow to 
save your manually entered text. 


Returns True (1) on success, 0 on failure. 

EXAMPLE NoteSet ( "AMD" , "Jun 15, 2004: AMD will deliver its first multi-core 
processors next year"); 

SEE ALSO NoteGetO function 

References: 


The NoteSet function is used in the following formulas in AFL on-line library: 

More Information: 

Updated on-line reference 


NoteSet - sets text of the note 
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Now 

- gets current system date/time 


Date/Time 


(AFL 2.3) 


SYNTAX Now( format = 0 ) 


RETURNS STRING or NUMBER 


FUNCTION Returns current date / time in numerous of formats: 


• format = 0 - returns string containing current date/time formatted according to system 
settings 

• format = 1 - returns string containing current date oniy formatted according to system 
settings 

• format = 2 - returns string containing current time only formatted according to system 
settings 

• format = 3 - returns DATENUM number with current date 

• format = 4 - returns TIMENUM number with current time 

• format = 5 - returns DATETIME number with current date/time 

• format = 6 - returns current DAY (1 ..31) 

• format = 7 - returns current MONTFI (1..12) 

• format = 8 - returns current YEAR (four digit) 

• format = 9 - returns current DAY OF WEEK (1 ..7, where 1 =Sunday, 2=Monday, and 
so on) 

• format = 10 - returns current DAY OF YEAR (1..366) 


EXAMPLE AddTextColumn( Now(), "Current time"); 

SEE ALSO DATENUMQ function , DATETIME() function , DATE() function , TIMENUM() function 

References: 

The Now function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• AFL Timing functions 

• AFLGIossaryl 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI(20) Divergence Indicator 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Heatmap VI 

• Herman 

• MFE and MAE and plot trades as indicator 

• Next Date Format 

• Time Left in Bar 

• Time Left to Current Bar 

• TWS auto-export Executions-file parser 

• Woodie's CCI Panel Basic 


Now - gets current system date/time 
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• Woodie's CCI Panel Full Stats 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


Now- gets current system date/time 
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NullCount 

- count consecutive Null values 


Miscellaneous functions 

(AFL 3.90) 


SYNTAX NullCount( array, mode = 1 ) 
RETURNS NUMBER 


FUNCTION Counts the number of consecutive nulls at the beginning of the array (mode = 1), at the end 
of the array (mode=2), from both ends (mode=3) and all nulls in the array (including 
non-consecutive) (mode=0) 

EXAMPLE X = MA( C, 20 ); 

printf ( "Empty values at the beginning = " + NullCount ( x ) ); 


SEE ALSO 
References: 


The NullCount function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


NullCount - count consecutive Null values 
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NumToStr 

- convert number to string 


String manipulation 

(AFL 2.5) 


SYNTAX NumToStr( NUMBER, format = 1.3, separator=Jrue, roundAndPad = False) 

NumToStr( ARRAY, format = 1.3, separator=Jrue, roundAndPad = False ) 

RETURNS STRING 

FUNCTION It is used to convert numeric vaiue of NUMBER or ARRAY to string. 

The second parameter - format - aiiows you to controi output formatting (decimai piaces and 
ieading spaces). The integer part of the number controis minimum number of characters 
used to dispiay the number (if you specify high number the output wili be space-padded). 

The fractional part defines how many decimal places to display, for example 1.0 - will give 
you a number without fractional part at all, and 1.2 - will give two digits past the decimal point 

There is also a special format constant formatDateTime that allows to convert date/time 
returned by DateTime() function formatted according to Windows regional settings. 

Third parameter separator (true by default) controls if thousand separator is added or not. 
Thousands separator is definable in Tools->Preferences->Misc. 


Fourth parameter roundAndPad controls whenever function rounds output beyond 7th 
significant digit (and pads the rest with zeros). By default rounding is OFF now because it 
was off in 5.90 and earlier and rounding introduced in 5.91 could confuse old time users 

Note: NumToStr is a synonym for WriteVal function. 

EXAMPLE 1. Simple use (no custom format) 


printf( NumToStr ( StochK(39) - StochK(12)) ); 

2. Display rate of change with 2 decimal digits and % appened to the end 


printf( NumToStr ( ROC ( Close, 20 ), 1.2 ) + "%%"); 
3. Display date/time according to regional settings 


printf ( NumToStr( DateTimeO, formatDateTime )); 

SEE ALSO WRITEVALQ function , StrToNum() function 

References: 

The NumToStr function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• 2 Timeframes Candlestick Bar Chart 

• 3 Price Break 

• 3TF Candlestick Bar Chart 

• Advanced Trend Lines with S & R 

• AFL Timing functions 


NumToStr - convert number to string 
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• AFL_Glossary_1 

• AFL_Glossary_Converter 

• ALJEHANI 

• Aroon The Advisor 

• AR_Prediction.afl 

• Auto Trade Step by Step 

• Auto Trader Basic Fiow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Dollar Price Volatility Exploration 

• Average Price Crossover 

• Basket Trading System T101 

• BEANS-Summary of Floldings 

• Bottom Fisher Exploration 

• Button trading using AB auto trading interface 

• Candle Identification 

• Candle Stick Analysis 

• Candle Stick Demo 

• Congestions detection 

• Continuous Contract Rollover 

• Coppock Trade Signal on Price Chart 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• DateNumDateStr 

• DEBAJ 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Fibonacci Moving averages 

• Fre 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gann Swing Charts in 3 modes with text 

• Gordon Rose 

• Heatmap VI 

• Heikin Ashi Candles 

• Hurst "Like" DE 

• IBD relative strength database ranker 

• IBD relative strength database Viewer 

• JEEVAN'S SRI CHAKRA 

• lastNDaysBeforeDate 

• Manual Bracket Order Trader 

• Market Breadth Chart-In-Chart 

• Market Profile 

• MFE and MAE and plot trades as indicator 

• nth (1 - 8 ) Order Polynomial Fit 

• Option Calls, Puts and days till third friday. 

• Ord Volume 

• Pivots And Prices 

• Point & figure Chart India Securities 

• prakash 

• Probability Density & Gaussian Distribution 

• Ranking and sorting stocks 


NumToStr - convert number to string 
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• Square of Nine Roadmap Charts 

• suresh 

• TD Sequential 

• Time Left in Bar 

• Time Left to Current Bar 

• tomy_frenchy 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• TWS auto-export Executions-file parser 

• Visi-Trade 

• Volume Color with Dynamic Limit 

• Volume Occilator 

• WLBuildProcess 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

More information: 

Updated on-line reference 


NumToStr- convert number to string 
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- negative volume index 


SYNTAX 

nvi() 

RETURNS 

ARRAY 

FUNCTION 

Calculates the Negative Volume Index 

EXAMPLE 


SEE ALSO 

The pvi() function 

References: 



The NVI function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


AmiBroker Formuia Language (AFL) 

Indicators 


NVI - negative volume index 
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Nz 

- Null (Null/Nan/Infinity) to zero 


Miscellaneous functions 


(AFL 2.3) 


SYNTAX Nz( X, valueifnull = 0 ) 


RETURNS NUMBER, ARRAY 


FUNCTION Converts Null/Nan/Infinity values to zero (or user defined value) 


X can be number or array. 

You can use the Nz function to return zero, or another specified value when argument x is 
Null or Nan or Infinite. 

For example, you can use this function to convert a Null (empty) value to another value and 
prevent it from propagating through an expression. If the optional valueifnull argument is 
included, then the Nz function will return the value specified by that argument if the x 
argument is Null (or Nan or Infinity). 


EXAMPLE You can use the Nz function as an alternative to the Ilf function. 


Instead of: 


varTemp = IIf( IsFinite( (H-L)/(C-L) ), (H-L)/(C-L), 0 ); 


You can write: 


varTemp = Nz( (H-L)/(C-L) ) ; 


SEE ALSO 
References: 

The Nz function is used in the following formulas in AFL on-line library: 

• AFL to Python COM Link 

• AR_Prediction.afl 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Button trading using AB auto trading interface 

• Candle Stick Analysis 

• Cycle Period 

• Dominant Cycle Phase 

• Dynamic Momentum Index 

• Dynamic Momentum Index 

• GFX ToolTip 

• Heatmap VI 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 
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• interactively test discretionary trading 

• John Ehler 

• Price Chart - Fundamental 

• Signal to Noise 

• Stochastic RSI 

• Stress with SuperSmoother 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Woodie's CCI Panel Full Stats 

More information: 

Updated on-line reference 


Nz- Null (Null/Nan/Infinity) to zero 
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Indicators 


OBV 

- on balance volume 


SYNTAX 

obv() 

RETURNS 

ARRAY 

FUNCTION 

Calculates the On Balance Volume indicator. 


EXAMPLE 


SEE ALSO 


References: 



The OBV function is used in the foilowing formuias in AFL on-line library: 

• candlestick chart for Volume/RSI/OBV 

• OBV with Linear Regression 

• Stochastic OBV and Price Filter 

More information: 

Updated on-line reference 


OBV - on balance volume 
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Optimize 

- define optimization variabie 


Trading system toolbox 

(AFL 1.7) 


SYNTAX Optimize( "description", defauit, min , max, step ) 

RETURNS NUMBER 

FUNCTION Defines optimization process parameters. With normai backtesting, scanning, expioration 

and comentary modes the optimize function returns default value, so the above function caii 
returns default, In optimization mode optimize function returns successive vaiues from min to 
max (inciusiveiy) with step stepping, "description" is a string that is used to identify the 
optimization variabie and is dispiayed as a coiumn name in the optimization resuit iist. default 
is a defauit value that optimize function returns in exploration, indicator, commentary, scan 
and normal back test modes min is a minimum value of the variable being optimized maxis a 
maximum value of the variable being optimized step is an interval used for increasing the 
value from min to max 


EXAMPLE variable = optimize("my optimization var", 9, 2, 20, 1 ); 

SEE ALSO 
Comments: 


Herman van den Bergen 

psytek@magma.ca 
2003-06-09 05:23:31 

You can Optimize parameters with custom number series by using the numbers 
generated by the Optimize() function as an index to access numbers in a 
custom array. Here is an example using a custom array FB[] of Fibonacci 
numbers: 

FB[0] = 0.0; FB[1] = 23.6; FB[2] = 38.2; FB[3] = 50.0; FB[4] = 61.8; FB[5] = 100; 
FB[6] = 161.8; FB[7] = 261.8; FB[8] = 423.6; 

FBindex = Optimize("FBindex",0,0,8,1); 

FibNum = FB[FBindex]; 

... place your Code using FibNum here ... 

Herman van den Bergen 

You can refresh your Equity chart after each Optimization step and observe (like 

psytek@magma.ca 

a slide show) how the linearity of your Equity curve is effected by adding these 

2003-07-20 17:26:08 

two lines to the very end of your code: 

AB = CreateObject("Broker.Application"); 

AB.RefreshAIIO; 

Important note: Do not use in commentary, interpretation, or indicator builder 
because it will cause loop. (Thanks for the tip TJ!) 

Graham Kavanagh 

When optimising for 2 or more variables make sure you have different names for 

gkavanagh@e-wire.net.au 

each variable. 

2004-08-21 23:31:39 

eg 

X = Optimize("Short",5,5,10,1); 
y = Optimize("Short",15,25,55,1); 

1 made mistake of copy/paste and did not change the optimize name (as above) 
within the brackets and got all zeroes as results. 


Optimize - define optimization variable 
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This below gets results 

X = Optimize("Short",5,5,10,1); 
y = Optimize("Long",15,25,55,1); 


Graham 

Tomasz Janeczko 

Some asked for function that combines ParamQ and Optimize(). Here it is: 

tj -at- amibroker.com 
2006-12-12 11:30:18 

function ParamOptimize( pname, defauitval, minv, maxv, step ) 

{ 

return Optimize( pname, 

Param( pname, defauitval, minv, maxv, step ), 
minv, maxv, step); 

} 


References: 


The Optimize function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Advanced MA system 

• ADXbuy 

• ATR Study 

• Auto-Optimization Framework 

• Automatic Linear Trend Channei 

• Automatic Linear Trend Channei 2 

• Awsome Osciiator 

• Boiiinger band normaiization 

• Buii Fear / Bear Fear 

• CoinToss ver 1 

• Dahi Osciiiator modified 

• danningham penetration 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• Effective Swing Indicator 

• ekeko price chart 

• EMA Crossover 

• Evaiuating Candie Patterns in a trading system 

• FastStochK FuliStochK-D 

• Fund Screener 

• ICHIMOKU SIGNAL TRADER 

• Inter-market Yield Linear Regression Divergence 

• Lagging MA-Xover 

• MACD optimize 

• Moving Averages NoX 

• Optimal Weights 

• OptimizationBatch.js 

• Perceptron 

• Peterson 

• Plot the Equity Curve without Backtesting? 

• Projection Oscillator 

• Rapid Prototyping Method for System Development 

• RUTVOL timing signal with BB Scoring routine 

• SectorRSI 


Optimize- define optimization variable 
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• STD_STK Multi 

• Stochastic Fast%K and Full 

• Stochastic optimize 

• StochD_StochK Single.afl 

• Super Trend Indicator 

• The D_oscillator 

• Trend Continuation Factor 

• Trend Following System 

• Trend Trigger Factor 

• TRIX 

• Vivek Jain 

• Volatility System 

• ZLEMA ATR Long Only Trading System 
More information: 

Updated on-line reference 


Optimize- define optimization variable 
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OptimizerSetEngine 
- select external optimization engine 


Trading system toolbox 

(AFL 3.20) 


SYNTAX OptimizerSetEngine( "name") 

RETURNS NOTHING 

FUNCTION The function selects external optimization engine defined by name. The following 
optimization engines are shipped with AmiBroker as of version 5.20 

• Standard Particle Swarm Optimizer ("spso") 

•Tribes (improved PSO) ("trib") 

• Covariance Matrix Adaptation Evolutionary Strategy ("cmae") 


New engines may be added in the future. 

EXAMPLE OptimizerSetEngine("spso"); 

SEE ALSO 
References: 


The OptimizerSetEngine function is used in the following formulas in AFL on-line library: 

• Optimal Weights 

• Perceptron 

More Information: 


Updated on-line reference 


OptimizerSetEngine - select external optimization engine 
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OptimizerSetOption 

- set the value of external optimizer engine parameter 


Trading system toolbox 

(AFL 3.20) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


OptimizerSetOptionC'name", value) 

NOTHING 

The function set additional parameters for external optimization engine. The parameters are 
engine-dependent. For example SPSO, TRIBES and CMAE optimizers support "Runs" 
(number of runs) and "MaxEval" (maximum evaluations (tests)per single run) parameters. 

OptimizerSetOption( "Runs", 2 ); 

OptimizerSetEngineO function 


The OptimizerSetOption function is used in the following formulas in AFL on-line library: 
• Perceptron 

More information: 


Updated on-line reference 


OptimizerSetOption - set the value of external optimizer engine parameter 
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Indicators 


OscP 

- price oscillator 


SYNTAX 

OscP( fast, slow) 

RETURNS 

ARRAY 

FUNCTION 

Calculates price oscillator based on exponential moving averages 

EXAMPLE 

oscp(9, 18) 

SEE ALSO 


References: 



The OscP function is used in the foiiowing formuias in AFL on-line library: 

• Indicator Explorer (ZigZag) 

• MACD commentary 

More information: 

Updated on-line reference 


OscP - price oscillator 
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OscV Indicators 

- volume oscillator 


SYNTAX 

OscV( fast, slow) 

RETURNS 

ARRAY 

FUNCTION 

Calculates volume oscillator based on exponential moving averages 

EXAMPLE 

oscv( 9, 18 ) 

SEE ALSO 


References: 



The OscV function is used in the foiiowing formuias in AFL on-line library: 

More information: 

Updated on-line reference 


OscV - volume oscillator 
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Outside Basic price pattern detection 

- outside bar 


SYNTAX 

RETURNS 

FUNCTiON 

EXAMPLE 

SEE ALSO 
References: 


OutsideO 

ARRAY 


Gives "true" (or 1) when an outside day occurs 
outsideO 


The Outside function is used in the foliowing formulas in AFL on-line library: 

• AC-i- acceleration 

• AO-i- Momentum indicator 

• Fund Screener 

• Gann Swing Chart 

• Gann Swing Charts in 3 modes with text 

• Vic Huebner 

• Williams Alligator system 

More information: 


Updated on-line reference 


Outside - outside bar 
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Param 

- add user user-definable numeric parameter 


Exploration / Indicators 

(AFL 2.3) 


SYNTAX Param( "name", defauitval, min, max, step, sincr = 0) 

RETURNS NUMBER 

FUNCTION Adds a new user-definable parameter, which will be accessible via Parameters dialog : 

right click over chart pane and select "Parameters" or press Ctrl-i-R allows to change chart 
parameters - changes are reflected immediatelly. 

• "name" - defines parameter name that will be displayed in the parameters dialog 

• defauitval - defines default value of the parameter 

• min, max - define minimum and maximum values of the parameter 

• step - defines minimum increase of the parameter via slider in the Parameters dialog 

• sincr - automatic section increment value (used by drag-drop interface to increase 
default values for parameters) 


WARNING: default/min/max/step parameters have to be CONSTANT numbers. This is 
because these values are cached and are not re-read during subsequent formula 
evaluations. 

EXAMPLE Sample code 1: 


ticker = ParamStr( "Ticker", "MSFT" ); 
sp = Param( "MA Period", 12, 2, 100 ) ; 

PlotForeign( ticker, "Chart of "iticker, ParamColor( "Price Color", 
colorLightYellow ), styleCandle ); 

Plot ( MA( Foreign( ticker, "C" ), sp ), "MA(" + WriteVal( sp, 1.0 ) 

+ ")", ParamColor( "MA Color", colorRed ) ); 

Sample code 2: 

sp = Param( "RSI Period", 12, 2, 100 ); 
r = RSI( sp ); 

Plot( r, "RSI("iWriteVal(sp,1.0)+")", ParamColor("RSI Color", 
colorRed ) ); 


Buy = Cross ( r, 30 ); 
Sell = Cross ( 70, r ); 


PlotShapes ( shapeUpArrow * Buy + shapeDownArrow * Sell, Ilf ( Buy, 
colorGreen, colorRed ) ); 

SEE ALSO PARAMCOLORO function , PARAMSTR() function PARAMCOLOR() function , ParamTime() 
function , ParamDateO function 

Comments: 


Tomasz Janeczko 

Note that Parameters are INDEPENDENT for each chart pane and for Automatic 

tj -at- 

Analysis window. 

amibroker.com 

In Automatic Analysis window parameters can be modified using "Parameters" button 

2006-02-19 

and they are independent from ones you use for any chart. 


Param - add user user-definable numeric parameter 
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06:18:23 


Tomasz Janeczko 

tj -at- 

amibroker.com 

2006-02-19 

06:19:59 

To change the parameters for the indicator, please click with RIGHT mouse button over 
chart pane and select "Parameters" from the menu. 


References: 


The Param function is used in the foliowing formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• 2 Timeframes Candlestick Bar Chart 

• 3 Price Break 

• 3TF Candlestick Bar Chart 

• Adaptive Centre of Gravity 

• Adaptive Cyber Cycle 

• Adaptive Laguerre Filter, from John Ehlers 

• Adaptive Price Channel 

• Adaptive Relative Vigour Index 

• Advanced MA system 

• Advanced Trend Lines with S & R 

• Adverse Move Ratio 

• ADX Indicator - Colored 

• AFL Example 

• AFL Example - Enhanced 

• AFL Timing functions 

• AFL to Python COM Link 

• AFL_Glossary_Converter 

• ALJEHANI 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• An n bar Reversal Indicator 

• Andrews Pitchfork 

• Andrews PitchforkV3.3 

• Animated BackGround 1.1 

• AO-i-Momentum 

• Application of Ehler filter 

• Arnaud Legoux Moving Average (ALMA) 

• Aroon The Advisor 

• AR_Prediction.afl 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Dollar Price Volatility Exploration 

• Average Price Crossover 


Param- add user user-definable numeric parameter 
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• babaloo chapora 

• Bad Tick Trim on 5 sec database 

• Baseiine Reiative Performance Watchiist charts V2 

• Basket Trading System T101 

• BEANS-Summary of Hoidings 

• Better Boliinger Bands 

• Black Scholes Option Pricing 

• Bman's HaDiffCO 

• bolingerbands 

• Bollinger - Keltner Bands 

• Bollinger Fibonacci Bands 

• bonlinger bands 

• Bottom Fisher Exploration 

• Brian Wild 

• Buff Volume Weighted Moving Averages 

• Bull/Bear Volume 

• Button trading using AB auto trading interface 

• Candle Stick Analysis 

• Candle Stick Demo 

• candlestick chart for Volume/RSI/OBV 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI(20) Divergence Indicator 

• Centre of Gravity 

• Chandelier Exit 

• Chandelier Exit 

• Chandelier Exit or Advanced Trailing Stop 

• Channel/S&R and trendlines 

• Chart Zoom 

• Color MACD Histogram Changes 

• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• com-out 

• Commodity Selection Index (CSI) 

• Congestions detection 

• ConnorsRSI 

• Controlling Height of Volume Bars 

• Coppock Histogram 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• Cyber Cycle 

• Cybernertic Hilbert Sine Wave 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Cycle Period 

• Dave Landry PullBack Scan 

• DEBAJ 

• Demand Index 

• DiNapoli Detrended Oscillator 

• Dinapoli Perferred Stochastic 

• Dominant Cycle Phase 

• DPO with shading 


Param- add user user-definable numeric parameter 
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• DT Oscillator 

• Dynamic Momentum Index 

• Dynamic Momentum Index 

• Dynamtic Momentum Index 

• Effective Swing Indicator 

• Ehlers Center of Gravity Oscillator 

• ekeko price chart 

• EKEKO SAR-MF 

• Elder Impulse Indicator 

• Elder Impulse Indicator V2 

• Elder Ray Oscillator with MA 

• Elder safe Zone Long + short 

• Elder Triple Screen Trading System 

• Elder's Market Thermometer 

• Elder's SafeZone Stop 

• ElderSafeZoneStopLong 

• ElderSafeZoneStopShort 

• Ergodic Oscillator 

• FastStochK FullStochK-D 

• Fib CMO 

• Fib Fan Based on ZZ 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Fisher Centre of Gravity 

• Fisher Cyber Cycle 

• Fisher Oscillator 

• Fisher Relative Vigour Index 

• Ere 

• Frequency distribution of returns 

• Future MA Projection 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gann level plotter 

• Gann Swing chart v41212 

• Gann Swing Charts in 3 modes with text 

• GFX ToolTip 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Harmonic Patterns 

• Heatmap V1 

• Heikin Ashi Delta 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• Hilbert Sine Wave 

• Hilbert Sine Wave with Hull Moving Average 

• Historical Volatility Index 

• Hull Moving Average 

• Hurst "Like" DE 

• Ichimoku Kinko Hyo 

• ICHIMOKU SIGNAL TRADER 

• IchimokuBrianVioreIRO 


Param- add user user-definable numeric parameter 
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• Indicator Explorer (ZigZag) 

• Intraday Average Volume 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 

• Intraday Trend Break System 

• Intraday Volume EMA 

• Inverted Plotted Volume Overlay Indicator 

• JEEVAN'S SRI CHAKRA 

• Jesse Livermore Secret Market Key 

• John Ehler 

• Kairi Relative Index 

• Kiss and Touch with the Modified True Range 

• Larry William's Volatility Channels 

• Linear Regression Line w/ Std Deviation Channels 

• Log Time Scale 

• LSMA 

• Lunar Phases - original 

• LunarPhase 

• MACD Histogram - Change in Direction 

• MACD indicator display 

• Market Breadth Chart-In-Chart 

• Market Profile 

• Meu Sistema de Trading - versao 1.0 

• MFE and MAE and plot trades as indicator 

• Mndahoo ADX 

• Model Four 

• Modified Head & Shoulder Pattern 

• Modified-DVI 

• Moving Averages NoX 

• MS Darvas Box with Exploration 

• Multicycle 1.0 

• Multiple Ribbon Demo 

• Multiple sinus noised 

• N Line Break Chart 

• NASDAQ 100 Volume 

• Non-repaitning Zigzag line 

• NoorDoodie 

• NRx Exploration 

• nth (1 - 8 ) Order Polynomial Fit 

• Optimal Weights 

• Option Calls, Puts and days till third friday. 

• Ord Volume 

• ParabXO 

• Parametric Chande Trendscore 

• Pattern_-_Rectangle_Base_Breakout_on_High_Vol 2 

• Percentage Price Oscillator 

• Perceptron 

• Pivot Finder 

• Pivot Point with S/R Trendlines 

• Pivots And Prices 

• Plot visual stop / target ratio. 

• Point & figure Chart India Securities 


Param- add user user-definable numeric parameter 
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• Position Sizer vers2, stocks and CFDs 

• Position Sizing and Risk Price Graph - 2 

• prakash 

• Probabiiity Density & Gaussian Distribution 

• Projection Osciilator 

• PVT Trend Decider 

• Random Walk 

• Random Walk Index 

• Random Walk Index, base formula included 

• Ranking and sorting stocks 

• Raw ADX 

• Rea Time Daily Price Levels 

• Relative Momentum Index (RMI) 

• Relative strength comparison with moving average 

• Relative Vigour Index 

• Renko Chart 

• Rl - Auto Trading System 

• RSI + Avgs 

• RSI indicator with Upper & Lower Zone Bars 

• RSI styleClipMinMax 

• SAR-ForNextBarStop 

• Scale Out: Futures 

• Scan New High and New Low 

• Schiff Lines 

• shailu lunia 

• Shares To Buy Price Graph 

• Signal to Noise 

• Simple Momentum 

• Smoothed Adaptive Momentum 

• Square of Nine Roadmap Charts 

• Standard Error Bands (Native AFL) 

• STARC Bands 

• Stochastic %J - KDJ 

• Stochastic Centre of Gravity 

• Stochastic Cyber Cycle 

• Stochastic Oscillator 

• Stochastic Relative Vigour Index 

• Stochastic RSI 

• Stop-loss Indicator bands 

• Stops on percentages 

• Stress with SuperSmoother 

• SUPER PIVOT POINTS 

• Support and Resistance 

• Support Resistance levels 

• TD Moving Average 2 

• TD REI 

• TD sequential 

• The Fibonaccian behavior 

• The Three Day Reversal 

• Three Day Balance Point 

• tomy_frenchy 

• Tracking Error 


Param- add user user-definable numeric parameter 
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• Tracking Error 

• Trailing Stop Loss 

• Trend Detection 

• Trend Lines from 2 points 

• Triangular Moving Average new 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Trix Bars number 

• TTM Squeeze 

• Twiggs Money Flow 

• Twiggs money flow weekly 

• Ultimate plus 

• ValueChart 

• VAMA 

• Vikram's Floor Pivot Intraday System 

• Visi-Trade 

• Visualization of stoploses and profit in chart 

• Vivek Jain 

• Volatility 

• Volume Color with Dynamic Limit 

• Volume Occilator 

• Volume wieghted moving average 

• VSTOP (2) 

• VSTOP (3) 

• William's Alligator System II 

• WILSON RELATIVE PRICE CHANNEL 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

• Woodies CCI 

• Z-Score Indicator 

• ZeroLag MACD(p,q,r) 

• Zig Explorer 

• Zig Zag 

• Zig-Hi Zap-Lo 

• ZigZag filter rewrited from scratch in AFL 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


Param- add user user-definable numeric parameter 
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ParamColor 

- add user user-definable color parameter 


Exploration / Indicators 

(AFL 2.3) 


SYNTAX ParamColor( "name", defaultcolor) 

RETURNS NUMBER 

FUNCTION Adds a new user-definable parameter, which will be accessible via Parameters dialog : 

right click over chart pane and select "Parameters" or press Ctrl-i-R allows to change chart 
parameters - changes are reflected immediatelly. 

• "name" - defines parameter name that will be displayed in the parameters dialog 

• defaultcolor - defines default color value of the parameter 


colorCycle - accepted only by ParamColor function as default value, causes that default color 
cycles through orange, blue, green, turquoise, gold, violet, bright green, dark yellow 

EXAMPLE Plot ( RSI(), "RSI", ParamColor( "RSI Color", colorRed ) ); 

SEE ALSO PARAMO function , PARAMSTR() function 

References: 


The ParamColor function is used in the following formulas in AFL on-line library: 

• Adaptive Laguerre Filter, from John Ehlers 

• Advanced MA system 

• Adverse Move Ratio 

• AFL to Python COM Link 

• ALJEHANI 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• Andrews Pitchfork 

• Andrews PitchforkV3.3 

• AO-nMomentum 

• Arnaud Legoux Moving Average (ALMA) 

• Aroon The Advisor 

• AR_Prediction.afl 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• Automatic Trendlines using multiple timeframes 

• Average Price Crossover 

• babaloo chapora 

• Bman's HaDiffCO 

• bolingerbands 

• bonlinger bands 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• Chandelier Exit 

• Chandelier Exit 

• CoinToss ver 1 

• Color MACD Histogram Changes 


ParamColor - add user user-definable color parameter 
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• Colorfull Price 

• Congestions detection 

• Controiiing Height of Voiume Bars 

• Coppock Trade Signai on Price Chart 

• Coppock Trade Signai v1.1 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Dave Landry PullBack Scan 

• DEBAJ 

• DiNapoli Detrended Oscillator 

• Dinapoli MACD (DEMA) 

• DiNapolis 3x Displaced Moving Averages 

• DT Oscillator 

• Elder safe Zone Long -i- short 

• Elder Triple Screen Trading System 

• Elliott Wave Oscillator 

• FastStochK FullStochK-D 

• Fib CMO 

• Fib Fan Based on ZZ 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gann level plotter 

• Gann Swing Charts in 3 modes with text 

• GFX ToolTip 

• Heikin Ashi Delta 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• Heinkin-Ashi 

• HH-LL-PriceBar 

• Hilbert Sine Wave Support & Resistance 

• Ichimoku Kinko Hyo 

• ICHIMOKU SIGNAL TRADER 

• Intraday Average Volume 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 

• IntraDay Open Marker 

• Intraday Strength 

• JEEVAN'S SRI CHAKRA 

• Jesse Livermore Secret Market Key 

• Kairi Relative Index 

• Last Five Trades Result Dashboard - AFL code 

• Linear Regression Line w/ Std Deviation Channels 

• Lunar Phases - original 

• LunarPhase 

• Market Breadth Chart-In-Chart 

• Mndahoo ADX 

• Modified-DVI 

• MS Darvas Box with Exploration 

• Multiple sinus noised 

• Neural Network Powered Smooth/Predictive RSI V2 

• nifty 


ParamColor - add user user-definable color parameter 
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• Option Calls, Puts and days till third friday. 

• Ord Volume 

• ParabXO 

• Perceptron 

• Pivot Point with S/R Trendlines 

• Pivots And Prices 

• plot tomorrows pivots on an intraday database 

• Plot visual stop / target ratio. 

• Point & figure Chart India Securities 

• prakash 

• Price Chart - Fundamental 

• PVT Trend Decider 

• Random Walk 

• Random Walk Index 

• Rl - Auto Trading System 

• RSI + Avgs 

• RSI indicator with Upper & Lower Zone Bars 

• RSI styleClipMinMax 

• SAR-ForNextBarStop 

• Schiff Lines 

• shailu lunia 

• Simple Momentum 

• Square of Nine Roadmap Charts 

• Stochastic Oscillator 

• Stops on percentages 

• Super Trend Indicator 

• suresh 

• TD Channel-1 

• TD Channel-2 

• TD Moving Average I 

• Three Day Balance Point 

• Trend Lines from 2 points 

• TRENDAdvisor 

• TrendingRibbonArrowsADX 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Twiggs Money Flow 

• Twiggs money flow weekly 

• Ultimate plus 

• VAMA 

• Vikram's Floor Pivot Intraday System 

• Visible Min and Max Value Demo 

• Volume Color with Dynamic Limit 

• Volume Occilator 

• Volume wieghted moving average 

• VSTOP (2) 

• VSTOP (3) 

• VWAP versus Average Price 

• William's Alligator System II 

• WILSON RELATIVE PRICE CHANNEL 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 


ParamColor - add user user-definable color parameter 
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• Woodie's Heikin-Ashi Panel 

• Woodie's Price Panel With Woodie's Pivots 

• Woodies CCI 

• Zig-Hi Zap-Lo 

• ZigZag filter rewrited from scratch in AFL 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


ParamColor- add user user-definable color parameter 
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ParamDate 

- add user user-definable date parameter 


Exploration / Indicators 

(AFL 2.60) 


SYNTAX ParamDate( "Name", "Default date", format = 0 ); 

RETURNS NUMBER or STRING 

FUNCTION Adds a new user-definable date parameter, which will be accessible via Parameters dialog : 

right click over chart pane and select "Parameters" or press Ctrl-i-R allows to change chart 
parameters - changes are reflected immediatelly. 

• "name" - defines parameter name that will be displayed in the parameters dialog 

• "default date" - is a string holding date in any any format: YYYY-MM-DD, MM/DD/YY, 
DD-MM-YY, etc, etc. 

• format - defines return value format, allowable values are: 

0 - return value is a NUMBER and holds DateNum. le: 990503 for May 3, 1999, 

1 - return value is a STRING formatted holding date according to your windows 
regional settings 


WARNING: default parameter has to be CONSTANT. This is because these values are 
cached and are not re-read during subsequent formula evaluations. 

EXAMPLE start = ParamDate( "Start Date", "2003-05-03" ); 

SEE ALSO PARAMO function , PARAMCOLOR() function , PARAMSTRQ function , ParamTime() 
function 

References: 


The ParamDate function is used in the following formulas in AFL on-line library: 

• Continuous Contract Rollover 

• MFE and MAE and plot trades as indicator 

• Plot the Equity Curve without Backtesting? 

More Information: 

Updated on-line reference 


ParamDate - add user user-definable date parameter 
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Param Field 

- creates price field parameter 


Exploration / Indicators 

(AFL 2.70) 


SYNTAX ParamFleldC'name", field = 3 ) 

RETURNS ARRAY 

FUNCTION Allows to pick the Price field for the Indicator (field which Is used to calculate values of the 
Indicator). Function returns the array defined by field parameter. Default value = 3 returns 
Close array. The possible values of field parameter are: 


• -1 - ParamFleld returns the values of the Indicator that was Inserted as a first one 
Into the pane, or Close If no Indicator was present 

• 0 - returns Open array 

• 1 - returns High array 

• 2 - returns Low array 

• 3 - returns Ciose array (default) 

• 4 - returns Average array = (FI+L+C)/3 

• 5 - returns Voiume array 

• 6 - returns Open interest array 

• 7,8,9,.... - return values of Indicators Inserted Into the pane. 


EXAMPLE 

SEE ALSO PARAMO function 

References: 


The ParamFieid function Is used In the following formulas In AFL on-line library: 

• Adaptive Laguerre Filter, from John Ehlers 

• Advanced MA system 

• AFL to Python COM Link 

• AO-i-Momentum 

• Arnaud Legoux Moving Average (ALMA) 

• AR_Predlctlon.afl 

• Average Price Crossover 

• babaloo chapora 

• Bman's HaDIffCO 

• bolingerbands 

• bonlinger bands 

• Dave Landry PullBack Scan 
• DEBAJ 

• Elder Triple Screen Trading System 

• Elder's Market Thermometer 

• Fibonacci Moving averages 

• Historical Volatility Index 

• Intraday FIbonacll Trend Break System 

• INTRADAY HEIKIN ASHI new 

• Kalrl Relative Index 

• Linear Regression Line w/ Std Deviation Channels 

• NoorDoodle 

• prakash 


ParamFieid - creates price field parameter 
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• regavg 

• Square of Nine Roadmap Charts 

• Stops on percentages 

• tomy_frenchy 

• Tracking Error 

• Tracking Error 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Vikram's Floor Pivot Intraday System 

More information: 

Updated on-line reference 


ParamField- creates price field parameter 
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ParamList 

- creates the parameter that consist of the list of choices 


Exploration / Indicators 

(AFL 2.70) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 
SEE ALSO 

References: 


ParamList( "Name", "Values", defauitval = 0) 

STRING 

Creates the parameter that consist of the list of choices (specified in Va/tves" parameter -1 or 
comma separated), defauitval parameter defines ordinal position of the default string value 
specified in Va/ues"parameter. Returned value is a STRING representing choosen item. 

OrderType = ParamList ( "Order Type", "MKT | LMT | STP" ); 

ParamDateO function , PARAMSTR() function , ParamTime() function , ParamTrigger() 
function , PARAMCOLORQ function , PARAM() function 


The ParamList function is used in the following formulas in AFL on-line library: 

• Advanced Trend Lines with S & R 

• Advisory NRx price chart display. 

• AFL_Glossary_Converter 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• AR_Prediction.afl 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Dollar Price Volatility Exploration 

• Average Price Crossover 

• babaloo chapora 

• Bad Tick Trim on 5 sec database 

• Bottom Fisher Exploration 

• Button trading using AB auto trading interface 

• candlestick chart for Volume/RSI/OBV 

• Daily High Low in Advance 
• DEBAJ 

• Demand Index 

• Gann Swing Charts in 3 modes with text 

• Graphical sector stock amalysis 

• Harmonic Patterns 

• Heatmap VI 

• Herman 

• Hurst "Like" DE 

• Intraday Fibonacii Trend Break System 

• JEEVAN'SSRI CHAKRA 

• Market Breadth Chart-In-Chart 

• Market Profile 


ParamList - creates the parameter that consist of the list of choices 
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• MFE and MAE and plot trades as indicator 

• Multiple Ribbon Demo 

• Murrey Math Price Lines 

• Point & figure Chart India Securities 

• Probability Density & Gaussian Distribution 

• Robert Antony 

• Scan New High and New Low 

• Square of Nine Roadmap Charts 

• SUPER PIVOT POINTS 

• TD Channel-1 

• TD Channel-2 

• Three Day Balance Point 

• Trend Lines from 2 points 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• William's Alligator System II 

• ZigZag Retracements 

More information: 

Updated on-line reference 


ParamList- creates the parameter that consist of the list of choices 
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ParamStr 

- add user user-definable string parameter 


Exploration / Indicators 

(AFL 2.3) 


SYNTAX ParamStr( "name", "default") 

RETURNS STRING 

FUNCTION Adds a new user-definable parameter, which will be accessible via Parameters dialog : 

right click over chart pane and select "Parameters" or press Ctrl-i-R allows to change chart 
parameters - changes are reflected immediatelly. 


• "name" - defines parameter name that will be displayed in the parameters dialog 

• "default" - defines default value of the parameter 

EXAMPLE ticker = ParamStr( "Ticker", "MSFT" ); 

SEE ALSO PARAMO function , PARAMCOLOR() function 

References: 


The ParamStr function is used in the following formulas in AFL on-line library: 

• AFL_Glossary_Converter 

• Continuous Contract Rollover 

• MFE and MAE and plot trades as indicator 

• Relative Strength Multichart of up to 10 tickers 

• Rene Rijnaars 

• Tracking Error 

• Tracking Error 

More information: 


Updated on-line reference 


ParamStr - add user user-definable string parameter 
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ParamStyle 

- select styles applied to the plot 


Exploration / Indicators 

(AFL 2.70) 


SYNTAX ParamStyleC'name", defaultstyle = styleLine, mask = maskDefault) 

RETURNS NUMBER 

FUNCTION Allows to select the styles applied to plot. 

Parameters 

• name - parameter name 

• defaultstyle - default value of style , takes combination of style* constants 

• mask - binary mask that defines which styles should be visible In the drop down list 
maskDefault - show thick, dashed, hidden, own scale styles (this Is default mask for 
ParamStyle) 

maskAII - show all style flags 

maskPrIce - show thick, hidden, own scale, candle, bar 
maskHlstogram - show histogram, thick, hidden, own scale, area 


EXAMPLE 

SEE ALSO 
References: 

The ParamStyle function Is used In the following formulas In AFL on-line library: 

• Adaptive Laguerre Filter, from John Ehlers 

• Advanced MA system 

• Adverse Move Ratio 

• Advisory NRx price chart display. 

• AFL to Python COM Link 

• ALJEHANI 

• AOn-Momentum 

• Arnaud Legoux Moving Average (ALMA) 

• Aroon The Advisor 

• AR_Predlctlon.afl 

• Auto Trader Basic Flow 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Price Crossover 

• babaloo chapora 

• Bman's HaDIffCO 

• bolingerbands 

• bonlinger bands 

• Chandelier Exit 

• Chandelier Exit 

• changing period moving average 

• Color MACD Histogram Changes 

• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• Colorfull Price 


ParamStyle - select styles applied to the plot 
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• Commodity Selection Index (CSI) 

• Controlling Height of Volume Bars 

• Coppock Trade Signal on Price Chart 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Daily High Low in Advance 

• Dave Landry PullBack Scan 

• DEBAJ 

• DiNapoli Detrended Oscillator 

• Dinapoli MACD (DEMA) 

• DiNapolis 3x Displaced Moving Averages 

• Elder safe Zone Long + short 

• Elder Triple Screen Trading System 

• Elliott Wave Oscillator 

• FastStochK FullStochK-D 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Gann level plotter 

• Gann Swing Charts in 3 modes with text 

• Harmonic Patterns 

• Heikin Ashi Delta 

• HH-LL-PriceBar 

• ICHIMOKU SIGNAL TRADER 

• interactively test discretionary trading 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 

• Intraday Strength 

• Intraday Trend Break System 

• Kairi Relative Index 

• Last Five Trades Result Dashboard - AFL code 

• Linear Regression Line w/ Std Deviation Channels 

• LunarPhase 

• Meu Sistema de Trading - versao 1.0 

• Mndahoo ADX 

• MS Darvas Box with Exploration 

• Multiple sinus noised 

• Murrey Math Price Lines 

• Neural Network Powered Smooth/Predictive RSI V2 

• nifty 

• Option Calls, Puts and days till third friday. 

• Perceptron 

• Pivot End Of Day Trading System 

• plot tomorrows pivots on an intraday database 

• Plot visual stop / target ratio. 

• prakash 

• Price Chart - Fundamental 

• PVT Trend Decider 

• Random Walk 

• Random Walk Index 

• Rebalancing Backtest avoiding leverage 

• Rl - Auto Trading System 

• RSI -I- Avgs 


ParamStyle - select styles applied to the plot 
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• RSI indicator with Upper & Lower Zone Bars 

• RSI styleClipMinMax 

• SAR-ForNextBarStop 

• Simple Momentum 

• Square of Nine Roadmap Charts 

• Stochastic Oscillator 

• Stress with SuperSmoother 

• Super Trend Indicator 

• suresh 

• TD Channel-1 

• TD Channel-2 

• TD Moving Average 2 

• TD Moving Average I 

• TrendingRibbonArrowsADX 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Twiggs Money Flow 

• Twiggs money flow weekly 

• Ultimate plus 

• Vikram's Floor Pivot Intraday System 

• Visible Min and Max Value Demo 

• Volume Color with Dynamic Limit 

• Volume Occilator 

• Volume wieghted moving average 

• William's Alligator System II 

• WILSON RELATIVE PRICE CHANNEL 

• Zig-Hi Zap-Lo 

• ZigZag filter rewrited from scratch in AFL 

• ZigZag Retracements 

More information: 

Updated on-line reference 


ParamStyle- select styles applied to the plot 
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ParamTime 

- add user user-definable time parameter 


Exploration / Indicators 

(AFL 2.60) 


SYNTAX ParamTime( "Name", "Default time", format = 0 ); 

RETURNS NUMBER or STRING 

FUNCTION Adds a new user-definable time parameter, which will be accessible via Parameters dialog : 

right click over chart pane and select "Parameters" or press Ctrl-i-R allows to change chart 
parameters - changes are reflected immediatelly. 

• "name" - defines parameter name that will be displayed in the parameters dialog 

• "default time" - is a string holding time in any any format: HH:MM:SS, HH:MM, etc. 

• format - defines return value format, allowable values are: 

0 - return value is a NUMBER and holds TimeNum. le: 133515 for 13:35:15 
1 - return value is a STRING formatted holding time according to your windows 
regional settings 


WARNING: default parameter has to be CONSTANT. This is because these values are 
cached and are not re-read during subsequent formula evaluations. 

EXAMPLE start = ParamTime( "Start Time", "09:30" ); 

SEE ALSO PARAMO function , PARAMCOLOR() function , ParamDate() function , PARAMSTR() 
function 

References: 


The ParamTime function is used in the following formulas in AFL on-line library: 
• MFE and MAE and plot trades as indicator 

More information: 


Updated on-line reference 


ParamTime - add user user-definable time parameter 
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ParamToggle 
- create Yes/No parameter 


Exploration / Indicators 

(AFL 2.70) 


SYNTAX ParamToggleC'name","values",defaultval=0 ) 

RETURNS NUMBER 

FUNCTION Function that allows to use boolean (Yes/No) parameters. 


• "name" - the name of the parameter 

• "values" - parameter values (separated with | character, e.g. "No|Yes" - first string 
represents false value and second string represents true value) 

• defauitval - default value of the parameter 


EXAMPLE 

SEE ALSO PARAMO function , ParamTrigger() function 

References: 


The ParamToggle function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Adaptive Centre of Gravity 

• Adaptive Cyber Cycle 

• Adaptive Relative Vigour Index 

• Advanced Trend Lines with S & R 

• AFL_Glossary_Converter 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• Aroon The Advisor 

• AR_Prediction.afl 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Price Crossover 

• Basket Trading System T101 

• BEANS-Summary of Holdings 

• Bid Vs Ask Dashboard 

• Brian Wild 

• Button trading using AB auto trading interface 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• Centre of Gravity 

• Channel/S&R and trendlines 


ParamToggle - create Yes/No parameter 
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• Congestions detection 

• Controiiing Height of Voiume Bars 

• Coppock Trade Signai on Price Chart 

• Coppock Trade Signai v1.1 

• Cyber Cycie 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Cycle Period 

• DEBAJ 

• Evaluating Candle Patterns in a trading system 

• Export EOD or Intraday to .csv file 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Fisher Centre of Gravity 

• Fisher Cyber Cycle 

• Fisher Oscillator 

• Fisher Relative Vigour Index 

• Fre 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gann Swing Charts in 3 modes with text 

• Harmonic Patterns 

• Heatmap V1 

• Heikin Ashi Delta 

• Hilbert Sine Wave Support & Resistance 

• ICHIMOKU SIGNAL TRADER 

• IchimokuBrianVioreIRO 

• interactively test discretionary trading 

• Intraday Fibonacii Trend Break System 

• Intraday Range and Periods Framer 

• Intraday Volume EMA 

• Inverted Plotted Volume Overlay Indicator 

• JEEVAN'S SRI CHAKRA 

• Manual Bracket Order Trader 

• Market Breadth Chart-In-Chart 

• Multiple sinus noised 

• N Line Break Chart 

• NASDAQ too Volume 

• NRx Exploration 

• Pivots And Prices 

• Point & figure Chart India Securities 

• prakash 

• Random Walk 

• Relative Vigour Index 

• RSI -I- Avgs 

• RSI indicator with Upper & Lower Zone Bars 

• Smoothed Adaptive Momentum 

• Square of Nine Roadmap Charts 

• Stochastic Centre of Gravity 

• Stochastic Cyber Cycle 


ParamToggle - create Yes/No parameter 
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• Stochastic Relative Vigour Index 

• Stochastic RSI 

• Stress with SuperSmoother 

• TD Sequential 

• Three Day Balance Point 

• Tracking Error 

• Trend Lines from 2 points 

• Triangle Search Extended 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Vikram's Floor Pivot Intraday System 

• Visi-Trade 

• Visualization of stoploses and profit in chart 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

More information: 

Updated on-line reference 


ParamToggle- create Yes/No parameter 
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ParamTrigger 

- creates a trigger (button) in the parameter diaiog 


Exploration / Indicators 

(AFL 2.70) 


SYNTAX ParamTrigger( "Name", "Button text") 

RETURNS NUMBER 

FUNCTION Creates trigger (button) in the Parameter diaiog. 


If you piace ParamTrigger in the indicator code it wiii create a "button" in Parameter diaiog 
that can be pressed. Normaiiy ParamTrigger wiii return zero (0) but when button in the param 
window is pressed then it wiii refresh the chart and ParamTrigger wiii return 1 (one) for this 
singie execution (further refreshes wiii return zero, untii the button is pressed again) 

EXAMPLE trigger = ParamTrigger ( "Place Order", "Click here to place order"); 


if ( trigger ) 

{ 

// your one-shot code here 
} 


SEE ALSO 
References: 


The ParamTrigger function is used in the foliowing formulas in AFL on-line library: 

• AFL Timing functions 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Button trading using AB auto trading interface 

• Chart Zoom 

• Continuous Contract Rollover 

• Heatmap VI 

• interactively test discretionary trading 

• Manual Bracket Order Trader 


More Information: 


Updated on-line reference 


ParamTrigger - creates a trigger (button) in the parameter dialog 
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PDI 

- plus directional movement indicator 


SYNTAX pdi( period = 14) 

RETURNS ARRAY 

FUNCTION Calculates Plus Directional Movement Indicator (-DI line) 

EXAMPLE decvolumeO 

SEE ALSO 
References: 


The PDI function Is used In the following formulas In AFL on-line library: 

• ADX Indicator - Colored 

• ADXbuy 

• AJDX system 

• babaloo chapora 

• CCI/Dk- COMBO Indicator 

• Commodity Selection Index (CSI) 

• Dave Landry Pullbacks 

• DMI Spread Index 

• ekeko price chart 

• Heatmap V1 

• ICHIMOKU SIGNAL TRADER 

• Index and ETF trading 

• Mndahoo ADX 

• Multiple Ribbon Demo 

• swing chart 

• The Three Day Reversal 

• Trend Analysls_Comentary 

• Trending Ribbon 

• TrendIngRIbbonArrowsADX 

• VIvek Jain 


More information: 


Updated on-line reference 


indicators 

(AFL 1.3) 


PDI - plus directional movement indicator 
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Peak 
- peak 


Basic price pattern detection 

(AFL 1.1) 


SYNTAX Peak(ARRAY, change, n = ^} 
RETURNS ARRAY 


FUNCTiON Gives the value of ARRAY n-th peak(s) ago. This uses the Zig Zag function (see Zig Zag) to 
determine the peaks, n =1 would return the value of the most recent peak, n =2 would return 
the value of the 2nd most recent peak. Caveat: this function is based on Zig-Zag indicator 
and may look into the future. 

EXAMPLE peak(close,5,1) 

SEE ALSO 

Comments: 


Tomasz Janeczko 

Zig/Peak/Trough functions work correctly for ARRAYS containing data greater than 

tj -at- amibroker.com 

zero. 

2003-02-13 04:02:04 



References: 


The Peak function is used in the following formulas in AFL on-line library: 

• Advanced Trend Lines with S & R 

• Andrews Pitchfork 

• Andrews PitchforkV3.3 

• Double top detection 

• ekeko price chart 

• Fund Screener 

• Gartley 222 Pattern Indicator 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• JEEVAN'S SRI CHAKRA 

• MACD commentary 

• Pivot Point with S/R Trendlines 

• Schiff Lines 

• Support Resistance levels 

• Tom DeMark Trend Lines 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Full Stats 

• ZigZag Retracements 

More information: 

Updated on-line reference 


Peak - peak 
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PeakBars 
- bars since peak 


Basic price pattern detection 

(AFL 1.1) 


SYNTAX PeakBars(ARRAY, change, n = ^) 

RETURNS ARRAY 


FUNCTiON Gives the number of bars that have passed from the n-th peak. This uses the Zig Zag 

function (see Zig Zag) to determine the peaks, n =1 wouid return the number of bars that 
have passed since the most recent peak, n =2 wouid return the number of bars that have 
passed since the 2nd most recent peak Caveat: this function is based on Zig-Zag indicator 
and may iook into the future. 

EXAMPLE peakbars(ciose,5,1) 

SEE ALSO 

References: 


The PeakBars function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Pivots And Prices And Swing Voiume 

• Advanced Trend Lines with S & R 

• DMI Spread Index 

• Fibonacci Internai and Externai Retracements 

• Future Piotting of Time and Price 

• Future Piotting of Time and Price 

• Gartiey 222 Pattern Indicator 

• Harmonic Patterns 

• Head & Shouiders Pattern 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• LunarPhase 

• Modified Head & Shouider Pattern 

• Pattern Recognition Expioration 

• Pivot Point with S/R Trendiines 

• QP2 Fioat Anaiysis 

• RSI Trendlines and Wedges 

• Stochastics Trendlines 

• The Fibonaccian behavior 

• Tom DeMark Trend Lines 

• Wolfe Wave Patterns 

• Zig-Hi Zap-Lo 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

More information: 


Updated on-line reference 


PeakBars - bars since peak 
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Percentile 

- calculate percentile 


Statistical functions 

(AFL 2.5) 


SYNTAX Percentile( array, period, rank) 

RETURNS ARRAY 

FUNCTION The Percentile function gives rank percentiie vaiue of the array over iast period bars. 


rank is 0..100 - defines percentiie rank in the array 

Performance note: the impiementation of percentiie function invoives sorting that is reiativeiy 
siow process even though that quicksort algorithm is used. 

Since version 5.92 Percentile supports variable period. 

Note that Percentile is very computation intensive function (it involves re-sorting arrays every 
bar) and variable-period version (if you call it with period being ARRAY) runs slower than 
scalar version 

EXAMPLE // Example 1; 

// show bars when 'current' Day Volume ranks within 

// TOP 30% of volumes of last 100 bars (Is above 70th Percentile) 

Filter = Volume > Percentile ( Volvime, 100, 70 ) ; 


// Example 2; 

// show bars when 'current' Day Volume ranks within 

// BOTTOM 30% of volumes of last 100 bars (is below 30th percentile) 

Filter = Volvime < Percentile ( Volvime, 100, 30 ) ; 


// variable period version 
bi = BarIndexO; 

X = Percentile ( Close, bi, 50 ); 

Plot ( X, "Cumulative 50% Percentile", colorRed ); 
Plot ( Close, "Price", colorDefault, styleCandle ); 


SEE ALSO MedianO function 

References: 


The Percentile function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


Percentile - calculate percentile 
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PercentRank 
- calculate percent rank 


Indicators 

(AFL 3.40) 


SYNTAX PercentRank( array, range ) 


RETURNS ARRAY 


FUNCTION INPUTS: 


• array - input data 

• range - lookback range 

Returns percent rank (0...100) of the current element of the array within all elements over the 
specified range. 

A value of 100 indicates that the current element of the array is the highest for the given 
lookback range, while a value of 0 indicates that the current value is the lowest for the given 
lookback range. 

It is equivalent (but 2x faster) to: 

function PercentRank2( Data, Periods) 

{ 

Count = 0; 

for ( i = 1; i <= Periods ; i++ ) 

{ 

Count += Data > Ref ( Data, -i ) ; 

} 

return 100 * Count / Periods; 

} 


EXAMPLE 

SEE ALSO 
References: 

The PercentRank function is used in the following formulas in AFL on-line library: 

• ConnorsRSI 
More Information: 

Updated on-line reference 
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PlaySound Miscellaneous functions 

- play back specified .WAV file ^ 


SYNTAX 

PlaySound( "filename") 

RETURNS 

NUMBER 

FUNCTION 

The function piays back specified .WAV fiie. 

Returns 1 on success, 0 on faiiure 

EXAMPLE 

PiaySound("c:\\windows\\media\\ding.wav"); 

SEE ALSO 


References: 



The PlaySound function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-iine reference 


PlaySound - play back specified. WA V file 
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Plot 

- plot indicator graph 


Exploration / Indicators 

(AFL 1.8) 


SYNTAX Plot( array, name, color/barcolor, style = styleLine, minvalue = {empty}, maxvalue = 
{empty}, XShift = 0, Zorder = 0, width = 1 ) 

RETURNS NUMBER 

FUNCTION Plots the graph using array data. Parameters: 


• array - data array to be plotted 

• name - defines graph name used for displaying values in a title bar. 

• color - defines plot color that could be static (if third argument is a number) or 
dynamic (when third argument is an array). Color indexes are related to the current 
palette (see Preferences/Color) 

• style is a combination of one or more of following values: 


StyleLine = 1 - normal (line) chart (default) 

styleHistogram = 2 - histogram chart 

styleThick =4 - fat (thick) 

styleDots = 8 - include dots 

styleNoLine = 16 - no line 

styleDashed = 32 - dashed line style 

styleCandle = 64 - candlestick chart 

styleBar = 128 - traditional bar chart 

styleNoDraw = 256 - no draw (perform axis scaling only) 

styleStaircase = 512 - staircase (square) chart 

styleSwingDots = 1024 - middle dots for staircase chart 

styleNoRescale = 2048 - no rescale 

styleNoLabel = 4096 - no value label 

stylePointAndFigure = 8192 - point and figure 

(new in 4.20): 

styleArea = 16384 - area chart (extra wide histogram) 
styleOwnScale = 32768 - plot is using independent scaling 

styleLeftAxisScale = 65536 - plot is using left axis scale (independent from right axis) 
styleNoTitle - do not display values of this plot in the chart title 
styleCloud - cloud style (area between high and low arrays) - to be used with 
PlotOHLC function 

styleClipMinMax - clip (do not paint) area between min and max levels - note this 
style is incompatible with printers and WMF (metafiles). 

styleGradient - (new in 5.60) - gradient area chart. Upper gradient color is specified 
by color parameter in Plot() function, bottom gradient color is either background color 
or can be defined using SetGradientFill function. styleGradient can be combined with 
StyleLine 

• minvalue and maxvalue - (used by styleOwnScale plots ONLY) define plot 
minimum and maximum values (lower and upper boundary for Y axis) 

• XShift - allows to visually shift the chart past the last bar. 

• ZOrder- defines the Z-axis position of given plot. The default is zero. Zorder = 0 
means also where the "grid" is located. So if you want to plot BEHIND the grid you 
need to specify negative zorder parameter.Plots are drawn in the following order: 


Plot - plot indicator graph 
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♦ zorder parameter takes precedence over the order of calling Plot() functions, 
so if z-order is set, it determines plotting order. See 
http://www.amibroker.com/gifs/zorder.gif 

♦ If multiple plots use the same z-order parameter they are plotted in reverse 
call order (ones that appear last in the code are plotted first). This rule can 
be changed by already existing switch graphzorder = 1 which, when 
specified, reverses this behaviour (so plots are drawn in call order). 

Please note the above applies to each zorder "layer" separately (so within 
same zorder "layer" reverse call rule applies) This may sound complicated 
but is required for backward compatibility. 

• width - defines pixel or percent width of given plot. The default is 1 pixel. Positive 
values specify PIXEL width, negative values specify width in percent of current bar 
width. So for example -20 will give you dynamic width that is 20% of bar width. 
Example: Plot( C, "Close", colorBlack, styleBar, Null, Null, 0, 1, -20 /* line width as 
percent of bar 7); 

EXAMPLE // Example 20-bar Moving average shifted 10 bars into the future 
past the last bar: 

Plot (Close, "Close" , colorBlack,styleCandle) ; 

Plot (MA (Close, 20) , "Shifted MA", colorRed, styleLine, Null, Null, 10 

) ; 

// Note that shift occurs during plotting AND does NOT affect source 
array 

SEE ALSO PLOTFOREIGNO function , PLOTGRID() function , PlotText() function , PLOTSHAPES() 
function , PLOTOHLCO function 

References: 

The Plot function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• % B of Bollinger Bands With Adaptive Zones 

• %b indicator - related bollinger bands 

• 'R' Channel 

• 10-20 Indicator 

• 2 Timeframes Candlestick Bar Chart 

• 3 Price Break 

• 30 Week Hi Indicator - Display 

• 3TF Candlestick Bar Chart 

• 52 Week New High-New Low Index 

• AccuT rack 

• Adaptave Zones 0/B & 0/S Oscillator 

• Adaptive Centre of Gravity 

• Adaptive Cyber Cycle 

• Adaptive Laguerre Filter, from John Ehlers 

• Adaptive Price Channel 

• Adaptive Relative Vigour Index 

• Advanced MA system 

• Advanced Trend Lines with S & R 

• Adverse Move Ratio 

• Advisory NRx price chart display. 

• ADX Indicator - Colored 


Plot- plot indicator graph 
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• ADXR 

• AFL Example 

• AFL Example - Enhanced 

• AFL Timing functions 

• AFL to Python COM Link 

• ALJEHANI 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• Andrews Pitchfork 

• Andrews PltchforkV3.3 

• Another Fib Level 

• AO+Momentum 

• Application of Ehler filter 

• Arnaud Legoux Moving Average (ALMA) 

• Aroon The Advisor 

• AR_Predlctlon.afl 

• Auto Trader Basic Flow 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• Automatic Trend-line 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Price Crossover 

• Awsome Oscllator 

• babaloo chapora 

• Bad Tick Trim on 5 sec database 

• Balance of Power 

• balance of power 

• Basket Trading System T101 

• BEANS-Summary of Holdings 

• Better Bollinger Bands 

• Bman's HaDIffCO 

• BMTRIX Intermediate Term Market Trend Indicator 

• bolingerbands 

• Bollinger - Keltner Bands 

• Bollinger Band Width 

• Bollinger Fibonacci Bands 

• bonlinger bands 

• Brian Wild 

• Bull/Bear Volume 

• Bullish Percent Index 2 files combined 

• Bullish Percent Index 2004 

• Button trading using AB auto trading Interface 

• Buyer Seller Force 

• Candle Identification 

• Candle Stick Analysis 

• Candle Stick Demo 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 


Plot- plot indicator graph 


938 



AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


• CCI Woodies Style 

• CCI(20) Divergence Indicator 

• Centre of Gravity 

• Chande Momentum Oscillator 

• Chande's Trend Score 

• Chandelier Exit 

• Chandelier Exit 

• Chandelier Exit or Advanced Trailing Stop 

• Chandelier Plugin 

• changing period moving average 

• Channel/S&R and trendlines 

• CoinToss ver 1 

• Color Display.afl 

• Color MACD Histogram Changes 

• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• Colorfull Price 

• com-out 

• Commodity Selection Index (CSI) 

• Composite Index 

• Congestions detection 

• Connors TPS 

• ConnorsRSI 

• Constant Trendline Plot 

• Continuous Contract Rollover 

• Controlling Height of Volume Bars 

• Coppock Histogram 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• correlerror 

• Cyber Cycle 

• Cybernertic Hilbert Sine Wave 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Cycle Period 

• Dahl Oscillator modified 

• Daily High Low in Advance 

• Dave Landry PullBack Scan 

• Days to Third Friday 

• DEBAJ 

• Demand Index 

• Digital indiactors 

• DiNapoli Detrended Oscillator 

• Dinapoli MACD (DEMA) 

• Dinapoli Perferred Stochastic 

• DiNapolis 3x Displaced Moving Averages 

• Distance Coefficient Ehlers Filter 

• Divergence indicator 

• Dominant Cycle Phase 

• Donchian Channel 

• DT Oscillator 

• Dynamic Momentum Index 


Plot- plot indicator graph 
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• Dynamic Momentum Index 

• Dynamtic Momentum Index 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• Effective Swing Indicator 

• Ehiers Center of Gravity Osciliator 

• Ehiers CyberCycie 

• Ehiers Dominant Cycle Period 

• Ehiers Fisher Transform 

• Ehiers Instantaneous Trend 

• Ehiers Laguerre RSI 

• ekeko price chart 

• EKEKO SAR-MF 

• Elder Impulse Indicator 

• Elder Impulse Indicator V2 

• Elder Ray - Bull Bear 

• Elder Ray Oscillator with MA 

• Elder safe Zone Long + short 

• Elder Triple Screen Trading System 

• Elder's Market Thermometer 

• Elder's SafeZone Stop 

• Elliott Wave Oscillator 

• Ema bands 

• EMA Crossover 

• EMA Crossover Price 

• Expiry day/days - Last thursday of month 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Fib CMO 

• Fib Fan Based on ZZ 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Fisher Centre of Gravity 

• Fisher Cyber Cycle 

• Fisher Oscillator 

• Fisher Relative Vigour Index 

• fishnet 

• Force index 

• Ere 

• Frequency distribution of returns 

• Future MA Projection 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Futures - Dollar Move Indicator 

• Futures - Dollar Move Today Indicator 

• Gabriel Linear Regression Angle Indicator 

• Gann level plotter 

• Gann Swing Charts in 3 modes with text 

• Gartley 222 Pattern Indicator 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 


Plot- plot indicator graph 
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• Harmonic Patterns 

• Heikin Ashi Delta 

• Herman 

• HH-LL-PriceBar 

• Hilbert Sine Wave 

• Hilbert Sine Wave with Hull Moving Average 

• Historical Volatility Index 

• Historical Volotility Scan - 6/100 

• Historical Volotility Scan - 50 Day 

• HLspread 

• Hull Moving Average 

• Hull Multiple Moving Averages 

• Hull Range Indicator 

• Hull Rate of Return Indicator 

• Hurst "Like" DE 

• IB Backfiller 

• Ichimoku Kinko Hyo 

• ICHIMOKU SIGNAL TRADER 

• Ichimoku with plot mofified to use cloud function 

• IchimokuBrianVioreIRO 

• IFT of RSI - Multiple TimeFrames 

• Improved NH-NH scan / indicator 

• Index of 30 Wk Highs Vs Lows 

• Indicator Explorer (ZigZag) 

• Instantaneous Trend Line 

• Inter-market Yield Linear Regression Divergence 

• interactively test discretionary trading 

• Intraday Average Volume 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 

• Intraday Range and Periods Framer 

• Intraday Strength 

• Intraday Trend Break System 

• Intraday Volume EMA 

• Inverted Plotted Volume Overlay Indicator 

• JEEVAN'S SRI CHAKRA 

• Jesse Livermore Secret Market Key 

• John Ehler 

• Kairi Relative Index 

• Kiss and Touch with the Modified True Range 

• Lagging MA-Xover 

• Last Five Trades Result Dashboard - AFL code 

• Linear Regression Line w/ Std Deviation Channels 

• Log Time Scale 

• LSMA 

• Luna Phase 

• LunarPhase 

• MACD Histogram - Change in Direction 

• MACD indicator display 

• MAM 

• Meu Sistema de Trading - versao 1.0 

• mfimacd 


Plot- plot indicator graph 
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• mitalpradip 

• Mndahoo ADX 

• MOCS 

• Modified Head & Shouider Pattern 

• Modified-DVI 

• Moving Averages NoX 

• Moving Trend Bands (MTB) 

• MO_CrashZone 

• MS Darvas Box with Expioration 

• Multicycle 1.0 

• Multiple Ribbon Demo 

• Multiple sinus noised 

• Murrey Math Price Lines 

• N Line Break Chart 

• NASDAQ 100 Volume 

• Neural Network Powered Smooth/Predictive RSI V2 

• nifty 

• nikhil 

• Non-repaitning Zigzag line 

• Nonlinear Ehlers Filter 

• NoorDoodie 

• nth (1 - 8 ) Order Polynomial Fit 

• Option Calls, Puts and days till third friday. 

• Ord Volume 

• P&F Chart - High/Low prices Sept2003 

• P&F chart with range box sizes 

• Parabolic SAR in native AFL (v.4.31.1 required) 

• ParabXO 

• Parametric Chande Trendscore 

• Percentage Price Oscillator 

• Perceptron 

• PF Chart - Close - April 2004 

• Pivot Calculator 

• Pivot End Of Day Trading System 

• Pivot Point with S/R Trendlines 

• Pivots And Prices 

• Pivots for Intraday Forex Charts 

• Plot the Equity Curve without Backtesting? 

• plot tomorrows pivots on an intraday database 

• Plot visual stop / target ratio. 

• Point & figure Chart India Securities 

• Polarized Fractal Efficiency 

• Position Sizer vers2, stocks and CFDs 

• Position Sizing and Risk Price Graph 

• Position Sizing and Risk Price Graph - 2 

• Positive Bars Percentage 

• prakash 

• Price Chart - Fundamental 

• Price with Woodies Pivots 

• Projection Oscillator 

• PVT Trend Decider 

• R-Squared 


Plot- plot indicator graph 


942 



AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


• Random Walk 

• Random Walk Index 

• Random Walk Index, base formula Included 

• Ranking and sorting stocks 

• Ranking Ticker WatchLIst 

• Rea Time Dally Price Levels 

• Rebalancing Backtest avoiding leverage 

• regavg 

• Relative Momentum Index (RMI) 

• Relative Strength Multichart of up to 10 tickers 

• Relative Vigour Index 

• Rene RIjnaars 

• Renko Chart 

• Reverse EMA function 

• Rl - Auto Trading System 

• Robert Antony 

• RSI + Avgs 

• RSI Indicator with Upper & Lower Zone Bars 

• RSI styleCllpMInMax 

• RSI Trendlines and Wedges 

• RSIS 

• RUTVOL timing signal with BB Scoring routine 

• SAR-ForNextBarStop 

• Schiff Lines 

• Second-order Infinite Impulse response filter 

• Shares To Buy Price Graph 

• Signal to Noise 

• Simple Momentum 

• Sine Wave Indicator 

• Smoothed Adaptive Momentum 

• Sony 

• Square of Nine Roadmap Charts 

• Standard Error Bands (Native AFL) 

• Steve Woods' Cum. Vol. Float -i- Cum. Vol. Channels 

• Steve Woods' Cumulative Vol. Percentage Indicator 

• Stochastic %J - KDJ 

• Stochastic Centre of Gravity 

• Stochastic Cyber Cycle 

• Stochastic of Weekly Price Array 

• Stochastic Oscillator 

• Stochastic Relative Vigour Index 

• Stochastic RSI 

• Stops on percentages 

• Stress with SuperSmoother 

• Super Trend Indicator 

• Support Resistance levels 

• suresh 

• T3 Function 

• TD Channel-1 

• TD Channel-2 

• TD Moving Average 2 

• TD Moving Average 1 


Plot- plot indicator graph 
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• TD sequential 

• TD Sequential 

• The D_oscillator 

• The Fibonaccian behavior 

• The Saturation Indicator D_sat 

• The Stochastic CCI 

• Three Day Balance Point 

• Three Pole Butterworth 

• Time Frame Weekly Bars 

• Time segment value 

• Tom DeMark Trend Lines 

• tomy_frenchy 

• Tracking Error 

• Tracking Error 

• Trading ATR 10-1 

• Trailing Stop Loss 

• Trend Detection 

• Trend Following System 

• Trend Lines from 2 points 

• Trend Trigger Factor 

• TRENDAdvisor 

• Trending Ribbon 

• TrendingRibbonArrowsADX 

• Triangular Moving Average 

• Triangular Moving Average new 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Trix Bars number 

• TTM Squeeze 

• Twiggs Money Flow 

• Twiggs money flow weekly 

• TWS auto-export Executions-file parser 

• Ultimate plus 

• Using From and To dates from Auto Analysis in Code 

• ValueChart 

• VAMA 

• Vertical Horizontal Filter (VHF) 

• Vikram's Floor Pivot Intraday System 

• Visi-Trade 

• Visible Min and Max Value Demo 

• Visualization of stoploses and profit in chart 

• Volatility 

• Volatility System 

• Volume - compared with Moving Avg (100%) 

• Volume Charts 

• Volume Color with Dynamic Limit 

• Volume Occilator 

• VSTOP (2) 

• VSTOP (3) 

• VWAP versus Average Price 

• William's Alligator System II 

• WILSON RELATIVE PRICE CHANNEL 

• Wolfe Wave Patterns 


Plot- plot indicator graph 
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• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

• Woodies CCI 

• z-distance from vwap 

• Z-Score Indicator 

• ZeroLag MACD(p,q,r) 

• Zig Zag 

• Zig Zag Indicator with Valid Entry and Exit Points 

• Zig-Hi Zap-Lo 

• ZigZag filter rewrited from scratch in AFL 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 
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PlotForeign 

- plot foreign security data 


Referencing other symbol data 

(AFL 2.2) 


SYNTAX PlotForeign( tickersymbol, name, color/barcolor, style = styleCandle / styleOwnScale, 
minvalue = {empty}, maxvalue = {empty}, XShift = 0, ZOrder = 0, width = 1 ) 

RETURNS NUMBER 

FUNCTION Plots the foreign-symbol price chart (symbol is defined by tickersymbol parameter). Second 
argument name defines graph name used for displaying values in a title bar. Graph color 
could be static (if third argument is a number) or dynamic (when third argument is an array). 
Color indexes are related to the current palette (see Preferences/Color) 
style defines chart plot style (see Plot() function for possible values) 
minvalue and maxvalue - (used by styleOwnScale plots ONLY) define plot minimum and 
maximum values (lower and upper boundary for Y axis) 

XShift - allows to visually shift the chart into future (blank) bars. 

ZOrder - this parameter takes precedence over the order of calling Plot() functions, so if 
z-order is set, it determines plotting order. See http://www.amibroker.com/gifs/zorder.gif 
If multiple plots use the same z-order parameter they are plotted in reverse call order (ones 
that appear last in the code are plotted first). This rule can be changed by already existing 
switch graphzorder = 1 which, when specified, reverses this behaviour (so plots are drawn in 
call order). 


Please note the above applies to each zorder "layer" separately (so within same zorder 
"layer" reverse call rule applies). This may sound complicated but is required for backward 
compatibility. 

width - defines pixel or percent width of given plot. The default is 1 pixel. Positive values 
specify PIXEL width, negative values specify width in percent of current bar width. So for 
example -20 will give you dynamic width that is 20% of bar width. Example: Plot( C, "Close", 
colorBlack, styleBar, Null, Null, 0, 1, -20 /* line width as percent of bar 7); 

EXAMPLE PlotForeign( "^DJI", "Dow Jones", colorRed ); 

SEE ALSO 
References: 


The PlotForeign function is used in the following formulas in AFL on-line library: 

• Dave Landry PullBack Scan 

• Elder Triple Screen Trading System 

• Intraday Fibonacii Trend Break System 

• qp2 industry charts as a panel in the stocks chart 

More information: 


Updated on-line reference 


PlotForeign - plot foreign security data 
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PlotGrid 

- Plot horizontal grid line 


Exploration / Indicators 

(AFL 2.3) 


SYNTAX PlotGrid( level, color = colorDefault, pattern = 1, width = 1, Label = True ) 

RETURNS NOTHING 

FUNCTION Plots hotizontal grid line using built-in dotted style at given level, color, pattern, width, with or 
without Label. 

New in version 5.90: 

• pattern - defines line pattern. Available grid patterns 1 ..10 as shown in the 
Tools->Preferences, "Axes & Grids", 1-7 are single pixel patterns, 8 is regular 
windows dot pattern (PS_DOT) , 9 is regular Windows dash pattern (PS_DASH), 10 
is solid line 

• width - grid line width (in pixels). Note that due to Windows GDI limitations only 
patterns 8 (PS_DOT), 9 (PS_DASH), 10 (PS_SOLID) are available in widths > 1 

• label - whenever to display value label or not 

Use PlotGrid to display horizontal lines that are constant instead of using Plot. PlotGrid offers 
much better performance in this case. 

So instead of 


Plot( 50,colorRed, styleLine | styleThick); 
use: 

PlotGrid( 50, colorRed, 10, 2, False ); // solid line 2 pixels thick, no label 

EXAMPLE PlotGrid( 25, colorRed ) ; 

SEE ALSO PLOT() function , PLOTFOREIGN() function , PLOTOHLC() function 

Comments: 


Tomasz Janeczko 

Instead of number you can also use expression but it must 

tj -at- amibroker.com 

be NUMERIC expression, not ARRAY. 

2003-04-18 07:12:14 



Use LastValue to convert: 


your_expression = ... 


PlotGrid( LastValue( your_expression )); 


References: 


The PlotGrid function is used in the following formulas in AFL on-line library: 

• Adverse Move Ratio 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI Woodies Style 


PlotGrid - Plot horizontal grid line 
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• Composite Index 

• Dynamic Momentum Index 

• Dynamic Momentum Index 

• Ehlers Center of Gravity Osciiiator 

• Ehiers Fisher Transform 

• Ehiers Laguerre RSI 

• IFT of RSI - Multiple TimeFrames 

• Kairi Relative Index 

• Multicycle 1.0 

• P&F chart with range box sizes 

• Rene Rijnaars 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• z-distance from vwap 

More information: 

Updated on-line reference 


PlotGrid- Plot horizontal grid line 
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PlotOHLC 

- plot custom OHLC chart 


Exploration / Indicators 

(AFL 2.2) 


SYNTAX PlotOHLC( open, high, low, close, name, color/barcolor, style = styleCandle / 

styleOwnScale, minvalue = {empty}, maxvalue = {empty}, XShift = 0, ZOrder = 0, width 
= 1 ) 

RETURNS NUMBER 

FUNCTION Plots the price chart using custom open, high, low, close arrays supplied as parameters. Fifth 
argument name defines graph name used for displaying values in a title bar. Graph color 
could be static (if sixth argument is a number) or dynamic (when sixth argument is an array). 
Color indexes are related to the current palette (see Preferences/Color) 
style defines chart plot style (see Plot() function for possible values) 
minvalue and maxvalue - (used by styleOwnScale plots ONLY) define plot minimum and 
maximum values (lower and upper boundary for Y axis) 

XShift - allows to visually shift the chart into future (blank) bars. 

ZOrder - this parameter takes precedence over the order of calling Plot() functions, so if 
z-order is set, it determines plotting order. See http://www.amibroker.com/gifs/zorder.gif 
If multiple plots use the same z-order parameter they are plotted in reverse call order (ones 
that appear last in the code are plotted first). This rule can be changed by already existing 
switch graphzorder = 1 which, when specified, reverses this behaviour (so plots are drawn in 
call order). 

Please note the above applies to each zorder "layer" separately (so within same zorder 
"layer" reverse call rule applies) This may sound complicated but is required for backward 
compatibility. 


width - defines pixel or percent width of given plot. The default is 1 pixel. Positive values 
specify PIXEL width, negative values specify width in percent of current bar width. So for 
example -20 will give you dynamic width that is 20% of bar width. Example: Plot( C, "Close", 
colorBlack, styleBar, Null, Null, 0, 1, -20 /* line width as percent of bar 7); 

EXAMPLE PlotOHLC( 1.1‘Open, 1.1* High, 1.1* Low, 1.1* Close, "Price chart shifted 10% up", 
colorRed, styleCandle); 

SEE ALSO PLOT() function , PLOTFOREIGN() function 

References: 


The PlotOHLC function is used in the following formulas in AFL on-line library: 

• Aroon The Advisor 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• automatic trendlines using fractal patterns 

• babaloo chapora 

• Bollinger Fibonacci Bands 

• Brian Wild 

• candlestick chart for Volume/RSI/OBV 


PlotOHLC - plot custom OHLC chart 
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• com-out 

• Congestions detection 

• Constant Trendiine Piot 

• Cycie Period 

• Digitai indiactors 

• DPO with shading 

• Elder Tripie Screen Trading System 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Gordon Rose 

• Heatmap V1 

• Heikin Ashi Candles 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• Heinkin-Ashi 

• Hurst "Like" DE 

• ICHIMOKU SIGNAL TRADER 

• IchimokuBrianVioreIRO 

• Indicator Explorer (ZigZag) 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 

• Intraday Range and Periods Framer 

• Intraday Trend Break System 

• JEEVAN'S SRI CHAKRA 

• Log Time Scale 

• Lunar Phases - original 

• MACD Histogram - Change in Direction 

• Meu Sistema de Trading - versao 1.0 

• mfimacd 

• Monthly bar chart 

• MO_CrashZone 

• N-period candlesticks (time compression) 

• NASDAQ 100 Volume 

• Nick 

• nth (1 - 8 ) Order Polynomial Fit 

• Pivot Finder 

• Pivots for Intraday Forex Charts 

• Plot visual stop / target ratio. 

• Point & figure Chart India Securities 

• Prashanth 

• Price with Woodies Pivots 

• Rea Time Daily Price Levels 

• Renko Chart 

• RSI + Avgs 

• RSI indicator with Upper & Lower Zone Bars 

• RSI styleClipMinMax 

• shailu lunia 

• Stress with SuperSmoother 

• Three Line Break - TLB 

• ValueChart 

• Vikram's Floor Pivot Intraday System 

• Volume Occilator 

• Weekly chart 

• WILSON RELATIVE PRICE CHANNEL 


PlotOHLC - plot custom OHLC chart 
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• Woodie's Heikin-Ashi Panel 
More information: 

Updated on-line reference 


PlotOHLC- plot custom OHLC chart 
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PlotShapes 

- plots arrows and other shapes 


Exploration / Indicators 

(AFL 2.3) 


SYNTAX PlotShapes( shape, color, layer = 0, ypositlon = graphO, offset = -12, XShIft = 0); 
RETURNS NOTHING 

FUNCTION Plots arrows and other shapes on any chart pane. 

Parameters: 


• shape defines type of the symbol, when shape is zero nothing is plotted values other 
than zero cause plotting various pre-defined shapes. Odd values plot shape BELOW 
indicator, even values plot shape ABOVE indicator. 

• color defines color of shape 

• layer defines layer number on which shapes are plotted 

• yposition defines Y-position where shapes are plotted (by default they are plotted 
'around' graphO (first indicator) line) 

• offset - (or distance) parameter (by default -12 ), Offset is expressed in SCREEN 
pixels. Negative offsets shift symbols down, positive offsets shift symbol up. To place 
the shape exactly at ypostion, specify 0 as offset 

• (new in 5.66) XShift - allows to visually shift the the shapes by the specified number 
of bars (even past the last bar). 

Constants for shapes: 

shapeNone, shapeUpArrow, shapeDownArrow, shapeHollowUpArrow, 
shapeHollowDownArrow, shapeSmallUpTriangle, shapeSmallDownTriangle, 
shapeHollowSmallUpTriangle, shapeHollowSmallDownTriangle, shapeUpTriangle, 
shapeDownTriangle, shapeHollowUpTriangle, shapeHollowDownTriangle, 
shapeSmalISquare, shapeHollowSmalISquare, shapeSquare, shapeHollowSquare, 
shapeSmallCircle, shapeHollowSmallCircle, shapeCircle, shapeHollowCircle, shapeStar, 
shapeHollowStar, shapeDigitO, shapeDigitI, shapeDigit2, shapeDigitS, shapeDigit4, 
shapeDigitS, shapeDigit6, shapeDigitT, shapeDigitS, shapeDigit9, shapePositionAbove 

EXAMPLE Example 1: 

PlotShapes( IIF( buy, shapeDigit9 + shapePositionAbove, shapeNone ), 
colorGreen ); 

Example 2: 

GraphO=MACD 0; 

Graphl=Signal(); 

Buy=Cross(GraphO, Graphl); 

Sell=Cross(Graphl, GraphO); 

PlotShapes( ( Buy OR Sell ) * ( 1 + Cum( Buy OR Sell ) % 52 ), Ilf( 

Buy, colorGreen, colorRed ), 5 ); 

GraphXSpace = 5; 

SEE ALSO PLOT() function 


PlotShapes - plots arrows and other shapes 
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Comments: 


Tomasz Janeczko 

tj -at- 

amibroker.com 

2003-07-01 

09:31:04 

You can position your arrows relative to High/Low too. See the code below for the 
example: 

Buy=Cross(MACD(), SignalQ); 

Sell=Cross(Signal(), MACDQ); 

shape = Buy * shapeUpArrow -i- Sell * shapeDownArrow; 

Plot( Close, "Price", colorBlack, styleCandle ); 

PlotShapes( shape, llf( Buy, colorGreen, colorRed ), 0, llf( Buy, Low, High )); 

GraphXSpace = 5; 

Tomasz Janeczko 

ShapePositionAbove must NOT be used together with shapes that have positions 

tj -at- 

already 

amibroker.com 

included (all those which have "Down" or "Up" in the name). 

2006-06-07 

All "Down" shapes are positioned ABOVE already and "Up" shapes are positioned 

17:14:40 

BELOW already, 

so it makes no sense to add those two. 

So you may only use ShapePosition above to the following shapes: 
shapeSmalISquare, shapeHollowSmalISquare, shapeSquare, shapeHollowSquare, 
shapeSmallCircle, shapeHollowSmallCircle, shapeCircle, 
shapeHollowCircle, shapeStar, shapeHollowStar, shapeDigitO, shapeDigitI, 
shapeDigit2, shapeDigit3, shapeDigit4, shapeDigitS, 
shapeDigit6, shapeDigit7, shapeDigitS, shapeDigit9 


References: 


The PlotShapes function is used in the foliowing formulas in AFL on-line library: 

• 4% Model - Determine Stock Market Direction 

• Adaptive Centre of Gravity 

• Adaptive Cyber Cycle 

• Adaptive Relative Vigour Index 

• Advanced MA system 

• Advanced Trend Lines with S & R 

• Advisory NRx price chart display. 

• AFL Example 

• AFL Example - Enhanced 

• ALJEHANI 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• An n bar Reversal Indicator 

• Aroon The Advisor 

• Auto Trader Basic Flow 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• automatic trendlines using fractal patterns 


PlotShapes- plots arrows and other shapes 
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• Automatic Trendlines using multiple timeframes 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Awsome Oscilator 

• babaloo chapora 

• Brian Wild 

• Button trading using AB auto trading interface 

• Candle Stick Analysis 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• Centre of Gravity 

• Chandelier Exit 

• Chandelier Exit or Advanced Trailing Stop 

• Channel/S&R and trendlines 

• com-out 

• Congestions detection 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• Cyber Cycle 

• Dynamic Momentum Index 

• Dynamic Momentum Index 

• Dynamtic Momentum Index 

• Effective Swing Indicator 

• ekeko price chart 

• EKEKO SAR-MF 

• Elder Impulse Indicator 

• Elder Impulse Indicator V2 

• Elder safe Zone Long + short 

• Expiry Thursday for Indian markets 

• Fisher Centre of Gravity 

• Fisher Cyber Cycle 

• Fisher Oscillator 

• Fisher Relative Vigour Index 

• Fre 

• Gordon Rose 

• Heikin Ashi Delta 

• Hilbert Sine Wave Support & Resistance 

• Hull Moving Average 

• Hurst "Like" DE 

• ICHIMOKU SIGNAL TRADER 

• IchimokuBrianVioreIRO 

• IFT of RSI - Multiple TimeFrames 

• Indicator Explorer (ZigZag) 

• interactively test discretionary trading 

• Intraday Fibonacii Trend Break System 

• Intraday Range and Periods Framer 

• Intraday Trend Break System 

• JEEVAN'S SRI CHAKRA 

• Lagging MA-Xover 

• Last Five Trades Result Dashboard - AFL code 

• Lunar Phases - original 

• LunarPhase 


PlotShapes- plots arrows and other shapes 
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• Meu Sistema de Trading - versao 1.0 

• MFE and MAE and plot trades as indicator 

• mitalpradip 

• Modified Head & Shoulder Pattern 

• Moving Averages NoX 

• Perceptron 

• Pivot End Of Day Trading System 

• Pivot Finder 

• Relative Momentum Index (RMI) 

• Relative Vigour Index 

• Rl - Auto Trading System 

• RUTVOL timing signal with BB Scoring routine 

• shailu lunia 

• Stochastic Centre of Gravity 

• Stochastic Cyber Cycle 

• Stochastic Relative Vigour Index 

• Stochastic RSI 

• Stops on percentages 

• Stress with SuperSmoother 

• Super Trend Indicator 

• suresh 

• TD Moving Average 2 

• TD REI 

• TD sequential 

• TD Sequential 

• Three Day Balance Point 

• Trading ATR 10-1 

• Trailing Stop Loss 

• Trend Detection 

• Trend Following System 

• TrendingRibbonArrowsADX 

• Triangular Moving Average new 

• TTM Squeeze 

• TWS auto-export Executions-file parser 

• TWS trade plotter 

• Using From and To dates from Auto Analysis in Code 

• Vikram's Floor Pivot Intraday System 

• Visualization of stoploses and profit in chart 

• Volatility 

• Volatility System 

• Volume Occilator 

• Woodie's CCI Panel Full Stats 

• Zig Zag Indicator with Valid Entry and Exit Points 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 
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PlotText 

- write text on the chart 


Indicators 

(AFL 2.80) 


SYNTAX PlotText( "text", x, y, color, bkcolor = colorDefault, yoffset = 0 ) 
RETURNS NOTHING 

FUNCTION This function writes text in specified co-ordinates, 
where: 


• X - is x-coordinate in bars (iike in LineArray) 

• y - is y-coordinate in doliars 

• color is text color 

• bkcolor is background color 

• yoffset (new in 5.80) is a Y-axis offset in pixels 

If bkcolor is NOT specified (or equal to colorDefault) text is written with TRANSPARENT 
background, any other value causes solid background with specified background color. 

EXAMPLE Plot (C, "Price" , colorBlack, styleLine ); 

Plot (MA(C, 20) , "MA20", colorRed ); 


Buy=Cross( C, MA(C,20 ) ); 

Sell= Cross ( MA ( C, 20 ), C ); 


dist = 1 . 5*ATR (10); 


for ( 1=0; i < BarCount; i++ ) 

{ 

if ( Buyfi] ) PlotText ( "Buyn@" + C[ i ], i, L[ 1 ]-dist[i], 

colorGreen ); 

if( Sellfi] ) PlotText( "Selln@" + C[ i ], i, H[ i ]+dist[i], 

colorRed, colorYellow ); 

} 


PlotShapes ( Buy * shapeUpArrow + Sell * shapeDownArrow, IIf( Buy, 
colorGreen, colorRed ) ) ; 


SEE ALSO PLOT() function , PlotTextSetFont() function 

References: 


The PlotText function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• Auto Trader Basic Flow 

• Automatic Trendlines using multiple timeframes 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Channel/S&R and trendlines 


PlotText - write text on the chart 
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• Congestions detection 

• Expiry day/days - Last thursday of month 

• Fib Fan Based on ZZ 

• Fibonacci Caicuiations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• Fre 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gann Swing Charts in 3 modes with text 

• Harmonic Patterns 

• Hilbert Sine Wave Support & Resistance 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• JEEVAN'S SRI CHAKRA 

• MFE and MAE and plot trades as indicator 

• Ord Volume 

• Pivots And Prices 

• Point & figure Chart India Securities 

• Square of Nine Roadmap Charts 

• SUPER PIVOT POINTS 

• suresh 

• Trix Bars number 

• Visualization of stoploses and profit in chart 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

More information: 

Updated on-line reference 


PlotText- write text on the chart 
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PlotTextSetFont 

- write text on the chart with user-defined font 


Basic price pattern detection 

(AFL 2.80) 


SYNTAX PiotTextSetFont( "text", "fontname", pointsize, x, y, coior, bkcoior = coiorDefauit, 
yoffset = 0) 

RETURNS NOTHING 

FUNCTiON This function writes text in specified co-ordinates using specified font 
where: 

• 'text' is a text to display 

• 'fontname' is a type face name 

• pointsize is a font size in points 

• X - is x-coordinate in bars (like in LineArray) 

• y - is y-coordinate in dollars 

• coior is text color 

• bkcoior is background color 

• yoffset is Y-axis offset (in pixels) 

If bkcoior is NOT specified (or equal to coiorDefauit) text is written with TRANSPARENT 
background, any other value causes solid background with specified background color. 


The function also sets font for all subsequent calls to PlotText(). 

EXAMPLE Plot (C, "Price", coiorDefauit ) ; 

X = SelectedValue ( BarIndexO ); 

y = Close[ X ]; 


PlotTextSetFont ("E", "Wingdings", 40, x, y, colorGreen, 
coiorDefauit, -30 ); 

PlotText ( "C", BarCount, Close[ BarCount - 1 ], colorRed, 
coiorDefauit, -20 ); // will use new font too 

SEE ALSO PlotTextO function 

References: 


The PlotTextSetFont function is used in the following formulas in AFL on-line library: 

• Inside Bar 

• Inside Bar 


More information: 


Updated on-line reference 


PlotTextSetFont - write text on the chart with user-defined font 
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PlotVAPOverlay 

- plot Volume-At-Price overlay chart 


Exploration / Indicators 

(AFL 2.4) 


SYNTAX PlotVAPOverlay( lines = 300, width = 5, color = colorGreen, vapstyle = 0 ); 

RETURNS NOTHING 

FUNCTION Plots Volume-At-Price (VAP) overlay chart. Please note that there must be at least one 
regular Plot function in your formula for this to work, and there can be only one 
PlotVAPOverlay in one indicator. This function plots single segment for visible bars only. To 
plot multiple-segment VAP chart use PlotVAPOverlayA function. 


• vapstyle = 0 - left side, area fill, on top of all plots 

• vapstyle = 1 - right side, area fill, on top of all plots 

• vapstyle = 2 - left side, lines only, on top of all plots 

• vapstyle = 3 - right side, lines only, on top of all plots 

• vapstyle = 4 - left side, area fill, behind all plots 

• vapstyle = 5 - right side, area fill, behind all plots 

• vapstyle = 6 - left side, lines only, behind all plots 

• vapstyle = 7 - right side, lines only, behind all plots 

EXAMPLE Plot ( Close, "Price", colorWhite, styleCandle ); 

PlotVAPOverlay( Param("lines", 300, 10, 1000, 1) , 

Param("width",10,1,99,1), ParamColor("color", colorDarkBlue), 
Param("style",0,0,7, 1) ); 


SEE ALSO PLOT() function , PlotVAPOverlayA() function 

References: 


The PlotVAPOverlay function is used in the following formulas in AFL on-line library: 

More Information: 

Updated on-line reference 


PlotVAPOverlay - plot Volume-At-Price overlay chart 
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PlotVAPOverlayA 

- plot multiple-segment Volume-At-Price chart 

PlotVAPOverlayA( segments, lines = 300, width = 80, color = colorLightGrey, vapstyle 

= 4); 

NOTHING 

Plots multiple Volume At Price charts at user-defined points. 

Parameters: 

segments - is an array which holds 0 and 1 (False/True) values, where 1 indicates 
starting/ending point of each VAP segment 

AmiBroker will draw as many segments as there are '1' in the array. Note that minimum 
segment length is 2, so if entire array is filled with 1-s only, it won't draw anything. In other 
words, there must be zeros (at least one) between 1's. 

lines - number of vertical lines (resolution) 

width - percentage width of the VAP overlay relatative to segment length (0..100) 
color - the color of VAP chart 
vapstyle 

• vapstyle = 0 - left side, area fill, on top of all plots 

• vapstyle = 1 - right side, area fill, on top of all plots 

• vapstyle = 2 - left side, lines only, on top of all plots 

• vapstyle = 3 - right side, lines only, on top of all plots 

• vapstyle = 4 - left side, area fill, behind all plots 

• vapstyle = 5 - right side, area fill, behind all plots 

• vapstyle = 6 - left side, lines only, behind all plots 

• vapstyle = 7 - right side, lines only, behind all plots 

EXAMPLE Simplest example: 

Plot (C, "Close", colorBlack, styleCandle ); 

segments = Ilf ( Interval () < inDaily, Day(), Month () ); // draw 

dally or monthly VAP segments depending on display interval 
segments = segments != Ref ( segments , -1 ); 

PlotVAPOverlayA ( segments ); 


SYNTAX 

RETURNS 

FUNCTION 


Indicators 

(AFL 3.20) 


More complex example: 

_SECTION_BEGIN ("Price") ; 

SetChartOptions (0, chartShowArrows|chartShowDates); 

_N (Title = StrFormat (" {{NAME} } - {{INTERVAL}} {{DATE}} Open %g. Hi 
%g, Lo %g. Close %g (%.lf%%) {{VALUES}}", O, H, L, C, SelectedValue ( 


PlotVAPOverlayA - plot multiple-segment Volume-At-Price chart 
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ROC ( C, 1 ) ) ) ) ; 

Plot ( C, "Close", ParamColor ( "Color" , colorBlack ), styleNoTitle | 

ParamStyle ( "Style" ) | GetPriceStyle () ); 

_SECTION_END () ; 

_SECTION_BEGIN ("VAP") ; 

segments = Ilf ( Interval () < inDaily, Day(), Month () ); 

segments = segments != Ref ( segments , -1 ) ; 

PlotVAPOverlayA ( segments , Param ( "Lines" , 300, 100, 1000, 1 ), 

Param ( "Width" , 80, 1, 100, 1 ), ParamColor ( "Color" , colorGold ), 
ParamToggle ( "Side" , "Left|Right" ) | 2 * ParamToggle ( "Style" , 

"Fill I Lines" , 0) | 4*ParamToggle ( "Z-order" , "On topi Behind", 1 ) ); 

Plot (segments, colorLightGrey, styleHistogram | styleOwnScale ); 

_SECTION_END(); 

SEE ALSO PLOTVAPOVERLAYO function 

References: 

The PlotVAPOverlayA function is used in the foliowing formulas in AFL on-line library: 

More Information: 

Updated on-line reference 


PlotVAPOverlayA- plot multiple-segment Volume-At-Price chart 
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PopupWindow 
- display pop-up window 


Miscellaneous functions 

(AFL 3.0) 


SYNTAX PopupWindow( bodytext, captiontext, timeout = 5, left = -1, top = -1, width = -1, height 
= -1, captureFocus = True); 

RETURNS NOTHING 

FUNCTION The function creates and displays pop-up window with specified bodytext, captiontext. 
Parameters: 


• bodytext - the string containing the text of the window body 

• caption - the string containing the text of window caption 

• timeout - auto-close time in seconds (default 5 seconds) 

• left - top-left corner X co-ordinate (default = -1 -means auto-center) 

• top - top-left corner Y co-ordinate (default = -1 - means auto-center) 

• width = width in pixels, -1 - use default width 

• height = height in pixels, -1 - use default height 

• captureFocus - decides whenever popup window captures input focus or not 

EXAMPLE if ( ParamTrigger ( "Display Popup Window", "Press here" ) ) 

{ 

PopupWindow ( "Current time is: " + Now (), "Alert" , 2, 

640 *mtRandom (), 480 *mtRandom ()); 

} 

SEE ALSO ParamColorO function , ParamDateQ function , ParamFieldQ function , ParamList() function , 
PARAMSTRO function , ParamStyle() function , ParamTime() function , ParamToggle() 
function , ParamTriggerO function 

References: 


The PopupWindow function is used in the following formulas in AFL on-line library: 

• AFL_Glossary_Converter 

• Heatmap V1 

• MFE and MAE and plot trades as indicator 

More information: 


Updated on-line reference 


PopupWindow - display pop-up window 
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Prec Math functions 

- adjust number of decimal points of floating point number 


SYNTAX Prec(ARRAY, precision) 

RETURNS ARRAY 

FUNCTION Truncates ARRAY to precision decimal places. 

EXAMPLE The formula "prec( 10.12981,2 )" returns 10.120. The formula "prec( 10.12981,4 )" returns 
10.12980. 


SEE ALSO 
References: 


The Prec function is used in the following formulas in AFL on-line library: 

• CCI Woodies Style 

• Controlling Fleight of Volume Bars 

• GFX ToolTip 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Relative Strength Multichart of up to 10 tickers 

• Tracking Error 

• Tracking Error 

• Triangle exploration using P&F Chart 

• ZLEMA ATR Long Only Trading System 

More information: 


Updated on-line reference 


Prec - adjust number of decimal points of floating point number 
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Prefs 

- retrieve preferences settings 

SYNTAX Prefs( index) 

RETURNS NUMBER, STRING 

FUNCTION Retrieves preferences setting. Aiiowed /nc/ex vaiues are: 
0: FatLineChart; 

1: MarkQuotations; 

2: ChartVoiumeType; 

3: ShortTimeMA; 

4: STMARange; 

5: MidTimeMA; 

6: MTMARange; 

7: BoiiingerBands; 

8: Pref.BBFactor; 

9: ROC; 

10: RSI; 

11, 12, 13: MACD; 

14: StochSlow; 

15, 16, 17: Ultimate; 

18: VolumeType; 

19-22: /* reserved amiga only 7 
23: AutoArrange; 

24: LogChartScale; 

25: MaxChartQuot; 

26:TRIX; 

27: LongTimeMA; 

28: LTMARange; 

29: VolMARange; 

30: RelativeStrengthBase (string); 

31: LimitSave; 

32: LimitSaveRange; 

33: CCI; 

34: CCIAvg; 

35: Tooltips; 

36: MFI; 

37, 38: Chaikin; 

39: Datapath (string) 

40: DataTooltips; 

41: LoadAllWhenSelect; 

42: PartialLoad; 

43: PartialLoadQty; 

44, 45: TRIN; 

46: STMAType; 

47: MTMAType; 

48: LTMAType; 

49: ADX; 

50, 51: ParabolicSAR; 

52: EnableMainChartSAR; 


Miscellaneous functions 

(AFL 1.4) 


Prefs - retrieve preferences settings 
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53: DefaultPriceStyle; 

54: StockTreeMode; 

55: TickerListMode; 

EXAMPLE macd( prefs( 11 ), prefs( 12 ), prefs( 13 )); 

SEE ALSO 
References: 

The Prefs function is used in the foilowing formulas in AFL on-line library: 

• Dinapoli Guru Commentary 

• ekeko price chart 

• hassan 

• Moving Trend Bands (MTB) 

More information: 

Updated on-line reference 


Prefs- retrieve preferences settings 
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printf 

- Print formatted output to the output window. 


String manipulation 

(AFL 2.5) 


SYNTAX printf( formatstr ,...) 

RETURNS NOTHING 

FUNCTION The printf function formats and prints a series of characters and vaiues to the output 
window, which can be either commentary or interpretation window. 

If arguments follow the format string, the format string must contain specifications that 
determine the output format for the arguments. 

printf and StrFormat behave identically except that printf writes output to the window, while 
StrFormat does not write anything to output window but returns resulting string instead. 

Note 1: for numbers always use %f, %e or %g formatting, %d or %x will not work because 
there are no integers in AFL. 


Note 2: as of now only numbers and arrays can now be printed. For arrays 'selected value' is 
printed 

Note 3: to print a single percent-sign character, you can not type % alone, you must use %%. 

Note 4: read more about various % format specifiers on Microsoft site: 
http://msdn2.microsoft.com/en-us/library/56e442dc(VS.80).aspx 

EXAMPLE f or ( i = 0; i < 10; i++ ) 

{ 

printf ( "Hello world, line %gn", 1 ); 

} 

SEE ALSO StrFormatO function 

References: 


The printf function is used in the following formulas in AFL on-line library: 

• AFLGIossaryt 

• AR_Prediction.afl 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Button trading using AB auto trading interface 

• Congestions detection 

• DateNumDateStr 

• ekeko price chart 

• ICHIMOKU SIGNAL TRADER 

• interactively test discretionary trading 

• Manual Bracket Order Trader 

• MFE and MAE and plot trades as indicator 

• Multiple sinus noised 


printf - Print formatted output to the output window. 
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• nth (1 - 8 ) Order Polynomial Fit 

• prakash 

• Robert Antony 

• Square of Nine Roadmap Charts 

• Stochastic %J - KDJ 

• tomy_frenchy 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Ultimate plus 

• Visi-Trade 

• WLBuildProcess 

More information: 

Updated on-line reference 


printf- Print formatted output to the output window. 
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- positive voiume index 


SYNTAX 

pvi() 

RETURNS 

ARRAY 

FUNCTION 

Calculates the Positive Volume Index 

EXAMPLE 


SEE ALSO 

The nvi() function 

References: 



The PVI function is used in the foliowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 


AmiBroker Formuia Language (AFL) 

Indicators 


PVI - positive volume index 
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Random 

- random number 


Statistical functions 

(AFL 1.9) 


SYNTAX Random( seed = Null) 

RETURNS ARRAY 


FUNCTION Returns an array of random values in 0..1 range (to get single random value use LastValue( 
RandomO )) 

Seed is defined it initializes the seed of random number generator this allows to produce 
repetitive series of pseudo-random series. If seed is not specified - random number 
generator continues generation. To reinitialize the generator, use 1 as the seed argument. 
Any other value for seed sets the generator to a random starting point. 

EXAMPLE Example 1: 


GraphO = RandomO; // generates different sequence with each refresh 

Example 2: 

GraphO = Random(1); // generates the same sequence with each refresh 

SEE ALSO mtRandomQ function 

Comments: 


Tomasz 

Internally Random() function uses Microsoft C runtime library rand() function scaled to 

Janeczko 

cover 0..1 range: 

tj -at- 

amibroker.com 

(1.0*rand()/RAND_MAX) 

2007-02-27 

Now Microsoft's rand() function (used in all MS languages) is Linear Congruential 

09:42:14 

Pseudo-Random Number Generator coded using 32 bit integer arithmetic as follows: 


static long holdrand; 
int rand() 

{ 

holdrand = holdrand * 214013 -h 2531011; 
return ( holdrand » 16 ) & 0x7fff; 

} 


References: 


The Random function is used in the following formulas in AFL on-line library: 

• MFE and MAE and plot trades as indicator 

• Multiple sinus noised 

• Random Walk 

• RandomizeO 

More information: 

Updated on-line reference 


Random - random number 
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Random - random number 
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Ref 

- reference past/future values of the array 


SYNTAX Ref( ARRAY, period) 
RETURNS ARRAY 


FUNCTION References a previous or subsequent element in a ARRAY. A positive period references "n" 
periods in the future; a negative period references "n" periods ago. The function accepts 
periods parameter that can be constant as well as time-variant (array). 

EXAMPLE The formula "ref( CLOSE, -14 )" returns the closing price 14 periods ago. Thus, you could 

write the 14-day price rate-of-change (expressed in points) as "C - ref( C, -14 )." The formula 
''ref( C, 12 )" returns the closing price 12 periods ahead (this means looking up the future) 


SEE ALSO 
References: 


The Ref function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• 2 Timeframes Candlestick Bar Chart 

• 3 Price Break 

• 30 Week Hi Indicator - Calculate 

• 3TF Candlestick Bar Chart 

• 4% Model - Determine Stock Market Direction 

• 52 Week New High-New Low Index 

• AC-i- acceleration 

• Adaptave Zones 0/B & 0/S Oscillator 

• Adaptive Centre of Gravity 

• Adaptive Cyber Cycle 

• Adaptive Price Channel 

• Adaptive Relative Vigour Index 

• Advanced MA system 

• Advanced Trend Lines with S & R 

• Advisory NRx price chart display. 

• ADX Indicator - Colored 

• ADXbuy 

• ADXR 

• AFL Example 

• AFL Example - Enhanced 

• Against all odds 

• AJDX system 

• Alert Output As Ouick Rewiev 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• An n bar Reversal Indicator 

• Analytic RSI formula 

• Andrews Pitchfork 

• Andrews PitchforkV3.3 

• AO-i- Momentum indicator 

• AO-i-Momentum 


Ref - reference past/future values of the array 
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• Application of Ehler filter 

• Aroon 

• AR_Prediction.afl 

• ATR Study 

• Auto Analysis Closing Price Reversal 

• Auto Analysis Hook Reversal 

• Auto Analysis Island Reversal 

• Auto Analysis Key Reversal 

• Auto Analysis Open/Close Reversal 

• Auto Analysis Pivot Point Reversal 

• Auto Analysis Short-term Reversals Exploration 

• Auto-Optimization Framework 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• AutoTrade using an Exploration 

• Average Dollar Price Volatility Exploration 

• Awsome Oscilator 

• babaloo chapora 

• Bad Tick Trim on 5 sec database 

• Balance of Power 

• balance of power 

• Basket Trading System T101 

• BEANS-Summary of Holdings 

• Bman's HaDiffCO 

• Bollinger Band Gap 

• Bollinger band normalization 

• Bollinger Fibonacci Bands 

• Bottom Fisher Exploration 

• Bow tie 

• Brian Wild 

• Buff Volume Weighted Moving Averages 

• Bull/Bear Volume 

• Bullish Percent Index 2 files combined 

• Bullish Percent Index 2004 

• Buyer Seller Force 

• CAMSLIM Cup and Handle Pattern AFL 

• Candle Identification 

• Candle Pattern Function 

• Candle Stick Analysis 

• candlestick chart for Volume/RSI/OBV 

• Candlestick Comentary-Help needed 

• Candlestick Commentary 

• Candlestick Commentary Modified 

• Candlestick Commentary-modified 

• Candlestick Volume Bars with Moving Average 

• CandleStochastics 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI Woodies Style 


Ref - reference past/future values of the array 
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• CCI(20) Divergence Indicator 

• CCT Coppock Curve 

• CCT Kaieidoscope 

• Centre of Gravity 

• Chande Momentum Osciiiator 

• Chande's Trend Score 

• changing period moving average 

• Channel/S&R and trendiines 

• CoinToss ver 1 

• Cole 

• Color Coded Short Term Reversal Signals 

• Color MACD Histogram Changes 

• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• Colorfull Price 

• com-out 

• Commodity Channel Index 

• Commodity Selection Index (CSI) 

• Compare Sectors against Tickers 

• Composite Index 

• Congestions detection 

• Connors TPS 

• ConnorsRSI 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• crBeta 

• CVR-severe filter 

• Cyber Cycle 

• Cybernertic Hilbert Sine Wave 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Cycle Period 

• Dahl Oscillator modified 

• Daily High Low in Advance 

• danningham penetration 

• Dave Landry PullBack Scan 

• Dave Landry Pullbacks 

• Demand Index 

• Demand Index 

• DeMarker 

• Detailed Equity Curve 

• Digital indiactors 

• Dinapoli Guru Commentary 

• DiNapolis 3x Displaced Moving Averages 

• Distance Coefficient Ehlers Filter 

• Divergence indicator 

• Divergences 

• DMI Spread Index 

• Donchian Channel 

• Double top detection 

• DPO with shading 

• Dynamic Momentum Index 


Ref - reference past/future values of the array 
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• Dynamic Momentum Index 

• Dynamtic Momentum Index 

• Ed Seykota's TSP: EMA Crossover System 

• Effective Swing Indicator 

• Ehier's fiiters and indicators 

• Ehiers Center of Gravity Osciliator 

• Ehiers CyberCycie 

• Ehiers Dominant Cycle Period 

• Ehiers Fisher Transform 

• Ehiers Instantaneous Trend 

• EKEKO SAR-MF 

• Elder Impulse Indicator 

• Elder Impulse Indicator V2 

• Elder safe Zone Long + short 

• Elder Triple Screen Trading System 

• Elder's Market Thermometer 

• Elder's SafeZone Stop 

• ElderSafeZoneStopLong 

• ElderSafeZoneStopShort 

• Ema bands 

• EMA Crossover 

• End Of Year Trading 

• Evaluating Candle Patterns in a trading system 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• FastStochK FullStochK-D 

• Fib CMO 

• Fib Fan Based on ZZ 

• Fibonacci Calculations & Speed Resistance 

• Fisher Centre of Gravity 

• Fisher Cyber Cycle 

• Fisher Relative Vigour Index 

• Follow the Leader 

• Force index 

• Ere 

• Frequency distribution of returns 

• Fund Screener 

• Future MA Projection 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Futures - Dollar Move Today Indicator 

• Gann Five Day pullback 

• Gann HiLo Indicator and System 

• Gann Swing Chart 

• Gann Swing Charts in 3 modes with text 

• Gap and Circuit 

• garythompson 

• garythompson 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Harmonic Patterns 

• hassan 


Ref - reference past/future values of the array 
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• Heatmap V1 

• Heikin Ashi Delta 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• Heinkin-Ashi 

• HH-LL-PriceBar 

• Hilbert Study 

• Historical Volotility Scan - 6/100 

• Historical Volotility Scan - 50 Day 

• Hook Reversals 

• Hull Rate of Return Indicator 

• Hurst "Like" DE 

• Hurst Constant 

• IBD relative strength database ranker 

• Ichimoku Chart 

• Ichimoku charts 

• ICHIMOKU SIGNAL TRADER 

• Ichimoku with plot mofified to use cloud function 

• IchimokuBrianVioreIRO 

• IFT of RSI - Multiple TimeFrames 

• Improved NH-NH scan / indicator 

• Index and FTP trading 

• Index of 30 Wk Highs Vs Lows 

• Indicator Explorer (ZigZag) 

• Intraday Average Volume 

• INTRADAY HEIKIN ASHI new 

• IntraDay Open Marker 

• Intraday Range and Periods Framer 

• Intraday Strength 

• Intraday Volume EMA 

• JEEVAN'S SRI CHAKRA 

• Kagi Chart 

• Kiss and Touch with the Modified True Range 

• Lagging MA-Xover 

• Larry William's Volatility Channels 

• Linear Regression Line w/ Std Deviation Channels 

• LSMA 

• Lunar Phases - original 

• MACD commentary 

• MACD indicator display 

• Main price chart with Rainbow & SAR 

• Manual Bracket Order Trader 

• Market Direction 

• Market Facilitation Index VS Volume 

• Market Profile 

• Meu Sistema de Trading - versao 1.0 

• MFE and MAE and plot trades as indicator 

• mfimacd 

• mitalpradip 

• Modified Momentum Finder DDT-NB 

• Modified-DVI 

• Momentum 

• Momentum 


Ref - reference past/future values of the array 
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• Monthly bar chart 

• Monthly Coppock Guide 

• Moving Average "Crash" Test 

• Moving Averages NoX 

• MO_CrashZone 

• MS Darvas Box with Expioration 

• Multicycle 1.0 

• Multiple Ribbon Demo 

• N Line Break Chart 

• N-period candlesticks (time compression) 

• Neural Network Powered Smooth/Predictive RSI V2 

• Nick 

• Nonlinear Ehlers Filter 

• NoorDoodie 

• Now Send Push Notifications From Amibroker 

• NR4 Historical Volatility System 

• NRx Exploration 

• P&F Chart - High/Low prices Sept2003 

• P&F chart with range box sizes 

• Parametric Chande Trendscore 

• Pattern - Rectangle Base Breakout on High Vol 

• Pattern_-_Rectangle_Base_Breakout_on_High_Vol 2 

• Perceptron 

• Performance Check 

• Peterson 

• PF Chart - Close - April 2004 

• Pivot End Of Day Trading System 

• Pivot Point with S/R Trendlines 

• Pivots for Intraday Forex Charts 

• Point & figure Chart India Securities 

• Polarized Fractal Efficiency 

• Position Sizing and Risk Price Graph 

• Position Sizing and Risk Price Graph - 2 

• Positive Bars Percentage 

• Prashanth 

• Price Persistency 

• Price with Woodies Pivots 

• Price-Volume Rank 

• Probability Calculator 

• Probability Density & Gaussian Distribution 

• Projection Oscillator 

• Pullback System No. 1 

• PVT Trend Decider 

• Rainbow Charts 

• Rainbow Oscillator 

• Random Walk Index 

• Random Walk Index, base formula included 

• Range Expansion Index 

• Rapid Prototyping Method for System Development 

• Raw ADX 

• Rea Time Daily Price Levels 

• Regression Analysis Line 


Ref - reference past/future values of the array 
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• Relative Momentum Index (RMI) 

• Relative Strength Multichart of up to 10 tickers 

• Relative Vigour Index 

• Relative Vigour Index 

• Renko Chart 

• Reverse EMA function 

• ROC of MACD Weekly 

• RSI of Weekly Price Array 

• RSIS 

• RUTVOL timing signal with BB Scoring routine 

• Sainath Sidgiddi 

• Scan New High and New Low 

• Schiff Lines 

• Sector Tracking 

• SectorRSI 

• shailu lunia 

• Simple Momentum 

• Sine Wave Indicator 

• Smoothed Adaptive Momentum 

• Sony 

• Steve Woods' Cum. Vol. Float + Cum. Vol. Channels 

• Stochastic Centre of Gravity 

• Stochastic Cyber Cycle 

• Stochastic Divergence, negative 

• Stochastic Divergence, positive 

• Stochastic Divergences, PDI, NDI 

• Stochastic Fast%K and Full 

• Stochastic of Weekly Price Array 

• Stochastic Relative Vigour Index 

• Stochastic RSI 

• Stops Implementation in AFS 

• Strength and Weakness 

• Stress with SuperSmoother 

• SUPER PIVOT POINTS 

• swing chart 

• TAZ Trading Method Exploration 

• TD Moving Average I 

• TD REI 

• TD sequential 

• TD Sequential 

• testing multiple system simulataneously 

• The Mean RSIt 

• The Mean RSIt (variations) 

• The Relative Slope 

• The Relative Slope Pivots 

• The Saturation Indicator D_sat 

• The Three Day Reversal 

• Three Day Balance Point 

• Three Line Break - TLB 

• Time Frame Weekly Bars 

• Time Left to Current Bar 

• Time segment value 


Ref - reference past/future values of the array 
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• Tom DeMark Trend Lines 

• tomy_frenchy 

• Tracking Error 

• Tracking Error 

• Trade day of month 

• Trading ATR 10-1 

• Trailing Stop Loss 

• Trend Analysis_Comentary 

• Trend Continuation Factor 

• Trend Detection 

• Trend Exploration: Count Number of New Flighs 

• Trend Following System 

• Trend Trigger Factor 

• Triangle exploration using P&F Chart 

• Triangle search 

• Triangle Search Extended 

• Triangular Moving Average 

• Triangular Moving Average new 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• TRIX 

• Trix Bars number 

• TTM Squeeze 

• Tushar Chande's Projected Range 

• Twiggs Money Flow 

• Twiggs money flow weekly 

• ValueChart 

• Varexiist 

• Vertical Florizontal Filter 

• Vertical Florizontal Filter (VHF) 

• Vic Huebner 

• Vikram's Floor Pivot Intraday System 

• Vivek Jain 

• Volatility Quality Index 

• Volatility System 

• Volume Color with Dynamic Limit 

• Volume Occilator 

• Volume Oscillator 

• VSTOP (2) 

• VWAP - Volume Weighted Average Price 

• VWAP versus Average Price 

• VWAP with standard deviation bands 

• Weekly chart 

• Weekly Trend in Daily Graph 

• Weinberg's The Range Indicator 

• William's Alligator System II 

• Williams Alligator system 

• WILSON RELATIVE PRICE CHANNEL 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Heikin-Ashi Panel 

• Woodie's Price Panel With Woodie's Pivots 


Ref - reference past/future values of the array 
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• Woodies CCI 

• Zig Explorer 

• Zig Zag Indicator with Valid Entry and Exit Points 

• Zig-Hi Zap-Lo 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

More information: 

Updated on-line reference 


Ref- reference past/future values of the array 
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RelStrength Referencing other symbol data 

- comparative relative strength ^ 


SYNTAX 

RelStrength( "tickername", fixup = 1) 

RETURNS 

ARRAY 

FUNCTION 

Calculates relative strength of currently selected security compared to "tickername" security. 
When you give an empty string as argument, a standard relative strength base security taken 
from Stock->Categories will be used. 

The last parameter - fixup - with the default value of 1 - causes filling the holes in the data 
with previous values (behaviour introduced in 3.90.3), if fixup is 0 - the holes are not fixed 
(the old, pre-3.90.3 behaviour) 

Note: you can still use Foreign/RelStrength in the old way: 

Foreign( "ticker", "field"), RelStrength( "ticker") - then the holes will be fixed. 

EXAMPLE 

relstrength( "^DJI") 

SEE ALSO 

Comments: 


jayson 

Interpretation 

2003-06-23 

09:20:02 

Comparative Relative Strength compares a security's price change with that of a "base" 
security. When the Comparative Relative Strength indicator is moving up, it shows that the 
security is performing better than the base security. When the indicator is moving sideways, it 
shows that both securities are performing the same (i.e., rising and falling by the same 
percentages). When the indicator is moving down, it shows that the security is performing 
worse than the base security (i.e., not rising as fast or falling faster). 

Comparative Relative Strength is often used to compare a security's performance with a 
market index. It is also useful in developing spreads (i.e., buy the best performer and short the 
weaker issue). 


References: 

The RelStrength function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Reiative Strength 

• Reiative strength comparison with moving average 

More information: 

Updated on-line reference 


RelStrength - comparative relative strength 
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RequestTimedRefresh 
- forces periodical refresh of indicator pane 


Indicators 

(AFL 2.90) 


SYNTAX RequestTimedRefresh( interval, onlyvisible = True ) 

RETURNS NOTHING 

FUNCTION The function causes given indicator window to refresh automaticaiiy every seconds 
regardiess of data source used or connection state. 

interval parameter defines timeout in seconds between refreshes. AmiBroker attempts to 
aiign refreshes to second boundaryso if you caii it RequestTimedRefresh( 5 ) you shouid get 
refreshes at 0, 5, 10, 15, 20, 25, 30, 35, 40, 45, 50 and 55 second of the minute.Due to the 
way how reguiar (iow overhead) timers are implemented in Windows they have accurracy of 
+/-55ms providedthat CPU is not very busy. Don't expect to get first line of your code to 
execute exactly at .000 milliseconds. This varies depending on machine load, number of 
quotes, system time slice and tens of other factors.Usually (on my testing machines) the first 
line of the code executes anywhere in the first 100 ms of the second, provided that other 
processes do not interfere. Windows is not real-time operating system and it does not 
guarantee any fixed execution/reaction times. 

onlyvisible parameter set to True (default value) means that refreshes are triggered only for 
visible and not minimised windows. This applies also to main AmiBroker window - when it is 
minimised charts are NOT refreshed by default. To force refreshes when window is 
minimised you need to set this parameter to False. Note that this visibility applies to mostly to 
'minimised' state or the situation when you move chart outside the boundary of physical 
screen so it is not visible to an eye but still open. It does not apply to chart windows that are 
on placed on inactive sheets, as they do not really exist until they are shown (this way 
AmiBroker conserves memory and CPU) and as non-existing, can not be refreshed. 

Hint: to detect whenever given refresh comes from timer or user action you can use 
Status("redrawaction") function. It returns 0 for regular refresh (user action) and 1 for 
timer-refresh 


Starting from version 5.30.3 RequestTimedRefresh supports sub-second (down to 0.1 sec) 
resolution, when enabled via registry setting 

(HKCU/Software/TJP/Broker/Settings/EnableHiresRTR, DWORD value = 1 ) 

EXAMPLE RequestTimedRef resh { 5 ) ; 

// automatically refresh this particular chart every 5 seconds 

SEE ALSO STATUSO function 

References: 


The RequestTimedRefresh function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Animated BackGround 

• Animated BackGround 1.1 

• Auto Trade Step by Step 


RequestTimedRefresh - forces periodical refresh of indicator pane 
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• Auto Trader Basic Flow 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Button trading using AB auto trading interface 

• CoinToss ver 1 

• Continuous Contract Rollover 

• GFX ToolTip 

• Fleatmap VI 

• Visi-Trade 

• Volume Charts 

• ZLEMA ATR Long Only Trading System 
More information: 

Updated on-line reference 


RequestTimedRefresh- forces periodical refresh of indicator pane 
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RestorePriceArrays 

- restore price arrays to original symbol 


Referencing other symbol data 

(AFL 2.5) 


SYNTAX RestorePriceArrays( tradeprices = False ) 

RETURNS NOTHING 

FUNCTION The RestorePriceArrays restores original price and volume arrays after the call to 

SetForeign. 

tradeprices parameter has to match the one used in SetForeionf) function. 


When tradeprices argument is set to TRUE, then not only OHLC, V, 01, Avg arrays are 
restored, but BuyPrice, SellPrice, ShortPrice, CoverPrice, PointValue, TickSize, 
RoundLotSize, MarginDeposit variables too. 

new in 5.90 - it can be also used to restore OHLC arrays that were directly overwritten by the 
user (without calling TimeFrameSet or Foreign). 

EXAMPLE // Example 1: Plot the indicator using foreign security data 
SetForeign ( "MSFT" ); 

Plot ( Ultimate 0, "Ultimate from MSFT", colorRed ); 
RestorePriceArrays (); 


// Example 2: Use SetForeign with Equity function 
SetForeign ( "MSFT" , True, True ); 

Buy = Cross ( MACD (), Signal ()); 

Sell = Cross ( Signal (), MACD ()); 
e = Equity 0; // backtest on MSFT 
RestorePriceArrays ( True ); // 


SEE ALSO SetForeignO function , TimeFrameSet() function 

Comments: 


Tomasz Janeczko 

TimeFrameRestore and RestorePriceArrays 

tj -at- 

is essentially the same function. So please note that calling RestorePriceArrays also 

amibroker.com 

resets the time interval set by eventual previous call to TimeFrameSet 

2004-07-10 


07:03:50 



References: 


The RestorePriceArrays function is used in the following formulas in AFL on-line library: 

• BEANS-Summary of Holdings 

• Continuous Contract Rollover 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Heatmap V1 

• IBD relative strength database ranker 

• Improved NH-NH scan / indicator 

• Ranking and sorting stocks 


RestorePriceArrays - restore price arrays to original symbol 
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• Ranking Ticker WatchList 

• Stress with SuperSmoother 

More information: 

Updated on-line reference 


RestorePriceArrays- restore price arrays to original symbol 
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Reverse 

- reverse the order of the elements in the array 


Miscellaneous functions 

(AFL 3.90) 


SYNTAX Reverse( array, first = 0, last = -1 ) 

RETURNS 

FUNCTION Returns a new array with the order of the elements in specified range reversed. The range is 
specified by first and last arguments. If last is not specified or negative then AmiBroker will 
use BarCount -1. 


EXAMPLE Filter = 1 ; 

AddColumn ( BarIndexO, "BI"); 

AddColumn ( Reverse ( BarIndexO ), "Reversed BI" ); 

SEE ALSO Sort() function 

References: 


The Reverse function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


Reverse - reverse the order of the elements in the array 
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RMI 

- Relative Momentum Index 

SYNTAX rmi( periods = 20, momentum = 5 ) 

RETURNS ARRAY 

FUNCTION Calculates Altman's Relative Momentum Index (S&C Feb 1993) 

EXAMPLE rml( 20, 5 ) 

SEE ALSO 
References: 

The RMI function Is used In the following formulas In AFL on-line library: 

• Relative Momentum Index (RMI) 

More Information: 

Updated on-line reference 


Indicators 

(AFL 2.1) 


RMI - Relative Momentum Index 
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ROC 

- percentage rate of change 


SYNTAX roc( ARRAY, periods =12, absmode = False ) 
RETURNS ARRAY 


FUNCTION Calculates the periods rate-of-change of ARRAY expressed as percentage. 

If absmode = False the value returned Is 100*( array - ref( array, -periods ) )/ref( array, 
-periods) 

If absmode = True the value returned Is 100*( array - ref( array, -periods ) )/abs( ref( array, 
-periods)) 

EXAMPLE The formula roc( CLOSE, 14) returns the 14-perlod percent rate-of-change of the closing 
prices. 

SEE ALSO 
References: 


The ROC function Is used In the following formulas In AFL on-line library: 

• Pivots And Prices And Swing Volume 

• AccuT rack 

• Adaptave Zones 0/B & 0/S Oscillator 

• Advanced MA system 

• Advanced Trend Lines with S & R 

• Advisory NRx price chart display. 

• AFL Example - Enhanced 

• Against all odds 

• Alpha and Beta and R_Squared Indicator 

• Andrews PltchforkV3.3 

• Aroon The Advisor 

• Auto Trade Step by Step 

• Auto-Optimizatlon Framework 

• Automatic Trend-line 

• Average Price Crossover 

• babaloo chapora 

• BEANS-Summary of Holdings 

• BMTRIX Intermediate Term Market Trend Indicator 

• Bollinger band normalization 

• Button trading using AB auto trading Interface 

• CCT Coppock Curve 

• Chaikin's Volatility 

• changing period moving average 

• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• Colorfull Price 

• Compare Sectors against Tickers 

• ConnorsRSI 

• Coppock Curve 

• Coppock Histogram 

• Coppock Trade Signal on Price Chart 


ROC - percentage rate of change 
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• Coppock Trade Signal v1.1 

• Customised Avg. Profit %, Avg. Loss % etc 

• CVR-severe filter 

• Daily High Low in Advance 

• Dave Landry PullBack Scan 

• DEBAJ 

• Demand Index 

• Detailed Equity Curve 

• DiNapolis 3x Displaced Moving Averages 

• DMI Spread Index 

• Elder safe Zone Long + short 

• Elder Triple Screen Trading System 

• End Of Year Trading 

• Envelope System 

• Fib Fan Based on ZZ 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Ere 

• Fund Screener 

• Futures - Dollar Move Today Indicator 

• Gann level plotter 

• Gann Swing Charts in 3 modes with text 

• GFX ToolTip 

• Harmonic Patterns 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• HH-LL-PriceBar 

• ICHIMOKU SIGNAL TRADER 

• Inter-market Yield Linear Regression Divergence 

• Intraday Fibonacii Trend Break System 

• Intraday Strength 

• Intraday Trend Break System 

• Know Sure Thing 

• LunarPhase 

• MFE and MAE and plot trades as indicator 

• Modified Momentum Finder DDT-NB 

• Monthly Coppock Guide 

• MS Darvas Box with Exploration 

• N Line Break Chart 

• nifty 

• OBV with Linear Regression 

• Option Calls, Puts and days till third friday. 

• Perceptron 

• Pivot End Of Day Trading System 

• Pivots And Prices 

• plot tomorrows pivots on an intraday database 

• Polarized Fractal Efficiency 

• Position Sizing and Risk Price Graph 

• Position Sizing and Risk Price Graph - 2 

• prakash 

• Price Chart - Fundamental 

• PVT Trend Decider 

• Rebalancing Backtest avoiding leverage 


ROC - percentage rate of change 
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• Reverse MFI Crossover 

• Robert Antony 

• SAR-ForNextBarStop 

• Schiff Lines 

• SectorRSI 

• shailu lunia 

• Shares To Buy Price Graph 

• SIROC Momentum 

• Square of Nine Roadmap Charts 

• Super Trend Indicator 

• suresh 

• swing chart 

• TD Moving Average 2 

• TD Sequentiai 

• Trend Detection 

• Trend Expioration: Count Number of New Highs 

• TrendingRibbonArrowsADX 

• Varexiist 

• Vikram's Floor Pivot Intraday System 

• Volume - compared with Moving Avg (100%) 

• Volume Occilator 

• William's Alligator System II 

• WILSON RELATIVE PRICE CHANNEL 

• Zig Zag Indicator with Valid Entry and Exit Points 

• Zig-Hi Zap-Lo 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


ROC- percentage rate of change 
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Round Math functions 

- round number to nearest integer 


SYNTAX Round( NUMBER) 
round( ARRAY) 

RETURNS NUMBER, 

ARRAY 


FUNCTION Rounds NUMBER or ARRAY to the nearest integer. 

EXAMPLE The formula "round( +11.5 )" returns +12. The formula "round( -11.4 )" returns -11. 

SEE ALSO The ceilQ function; the floor() function; the int() function. 

References: 


The Round function is used in the following formulas in AFL on-line library: 

• Adaptive Price Channel 

• AR_Prediction.afl 

• Bad Tick Trim on 5 sec database 

• Bullish Percent Index 2 files combined 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI Woodies Style 

• Congestions detection 

• Continuous Contract Rollover 

• Dave Landry PullBack Scan 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• Elder Triple Screen Trading System 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Historical Volotility Scan - 50 Day 

• Hurst "Like" DE 

• Intraday Average Volume 

• JEEVAN'S SRI CHAKRA 

• Kagi Chart 

• Ord Volume 

• P&F Chart - High/Low prices Sept2003 

• PF Chart - Close - April 2004 

• Price with Woodies Pivots 

• Random Walk 

• Square of Nine Roadmap Charts 

• Triangle exploration using P&F Chart 

• Triangular Moving Average 

• Triangular Moving Average new 

• ValueChart 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 


Round - round number to nearest integer 
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More information: 

Updated on-line reference 


Round- round number to nearest integer 
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RSI 

- relative strength index 

SYNTAX RSI( periods =14) 

RSIa( array, periods = 14 ) 

RETURNS ARRAY 

FUNCTION Calculates the RSI Indicator using periods range 

Second version RSIa accepts Input array so It RSI can be applied to other arrays than close. 

EXAMPLE RSI(12) 

RSIa( High, 12); 

SEE ALSO 
Comments: 


Tomasz Janeczko 

tj -- at -- amlbroker.com 
2007-07-27 09:34:56 


// Internally RSI Is Implemented as follows 

// 

function BulltlnRSIEqulvalent( period ) 

{ 

P = N = 0; 
result = Null; 

for( I = 1; I < BarCount; I-i-h- ) 

{ 

diff = C[ I ] - C[ I -1 ]; 

W = S = 0; 

lf( dIff > 0 ) W = dIff; 

lf( diff < 0 ) S = -diff; 

P = (( period -1 ) * P H- W ) / period; 

N = (( period -1 ) * N -r S ) / period; 

lf( I >= period ) 

result[l] = 100*P/(P-HN); 

} 

return result; 

} 

Plot( BulltlnRSIEqulvalent( 14 ), "RSI 1", colorRed ); 
Plot( RSI( 14 ), "RSI 2", colorBlue ); 


References: 


The RSI function Is used In the following formulas In AFL on-line library: 

• Adaptave Zones 0/B & 0/S Oscillator 

• Against all odds 

• Bollinger band normalization 

• candlestick chart for Volume/RSI/OBV 


RSI - relative strength index 
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• CCT StochasticRSI 

• colored CCI 

• COMBO 

• Compare Sectors against Tickers 

• Composite Index 

• Connors TPS 

• ConnorsRSI 

• Derivative Oscillator 

• Divergence indicator 

• DT Oscillator 

• Ehlers Laguerre RSI 

• Follow the Leader 

• Fund Screener 

• ICHIMOKU SIGNAL TRADER 

• JEEVAN'S SRI CHAKRA 

• Multicycle 1.0 

• Overbought issues, Oversold issues 

• Perceptron 

• Ranking and sorting stocks 

• Relative Strength Index 

• RSI + Avgs 

• RSI Double-Bottom 

• RSI indicator with Upper & Lower Zone Bars 

• RSI Pointer 

• RSI styleClipMinMax 

• RSI Trendlines and Wedges 

• RSIS 

• SectorRSI 

• Support Resistance levels 

• testing multiple system simulataneously 

• Varexiist 

• Vivek Jain 

• Volatility System 

• WILSON RELATIVE PRICE CHANNEL 
More information: 

Updated on-line reference 


RSI- relative strength index 
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Indicators 


RWI 

- random walk index 


SYNTAX 

rwi( minperiods, maxperiods ) 

RETURNS 

ARRAY 

FUNCTION 

Calculates the Random Walk Index indicator as a difference between Random Walk Index 
from Highs (RWIHI() function) and Random Walk Index from Lows (RWILO() function. 

EXAMPLE 

rwi( 9, 40 ); 

SEE ALSO 


References: 



The RWI function is used in the foliowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 


RWI - random walk index 
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Indicators 


RWlHi 

- random walk index of highs 


SYNTAX 

RWIHi( minperiods, maxperiods ) 

RETURNS 

ARRAY 

FUNCTION 

Calculates the Random Walk Index from Highs. 

EXAMPLE 

rwihi( 9, 40 ); 

SEE ALSO 


References: 



The RWlHi function is used in the foiiowing formuias in AFL on-line library: 

• Random Walk Index 
More information: 

Updated on-line reference 


RWlHi - random walk index of highs 
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RWILo Indicators 

- random walk index of lows 


SYNTAX 

RWILo( minperiods, maxperiods) 

RETURNS 

ARRAY 

FUNCTION 

Calculates the Random Walk Index from Lows. 

EXAMPLE 

rwilo( 9, 40 ); 

SEE ALSO 


References: 



The RWILo function is used in the foilowing formulas in AFL on-line library: 

• Random Walk Index 
More information: 

Updated on-line reference 


RWILo - random walk index of lows 
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SAR 

- parabolic stop-and-reverse 


Indicators 

(AFL 1.3) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


sar( accel = 0.02, max = 0.2 ) 

ARRAY 

Calculates Parabolic SAR Indicator. Acceleration Is given by accel argument and maximum 
acceleration level Is given by max argument 

sar() 


The SAR function Is used In the following formulas In AFL on-line library: 

• EKEKO SAR-MF 

• Main price chart with Rainbow & SAR 

• Parabolic SAR In VBScript 

• Rl - Auto Trading System 

• Trend Analysls_Comentary 

• Volatility Breakout with Bollinger Bands 

More information: 


Updated on-line reference 


SAR - parabolic stop-and-reverse 
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Say 

- speaks provided text 


Miscellaneous functions 

(AFL 2.90) 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


SayC'text", purge = True) 

NUMBER 

Say() function speaks user-specified text (Windows XP, on iower-end Windows you need to 
instaii Microsoft Speech API, voice settings are in Windows Controi Panei) 

New in 5.20 - 'purge' parameter 

when purge is set to True (the defauit) - any cali to Say() purges ali previous speak requests 
(queued or in-progress) and speaks specified text immediateily. 

when purge is set to Faise - speak request is queued and wiii be spoken right after previous 
requests are done. 

Aiso now Say() function returns the NUMERIC value that indicates how many speak 
requests are pending 

0 - ERROR - speech engine not installed or not working properly 

1 - currently requested text is spoken now (queue was empty) 

2 or more - queue was not empty and previous request(s) will be completed prior to speaking 
currently specified text 

CAVEAT: Creative SoundBlaster X-Fi cards have a driver problems on Windows 7 and 
Windows Vista causing memory leak in audiodg.exe process (Windows Audio) when using 
audio output (esp. Say command). To workaround this X-Fi driver problem, do the following: 

1. right click the speaker icon in your taskbar 

2. select 'Playback Devices' 

3. right click the Speakers output 

4. select 'Properties' 

5. click on the 'Sound Blaster' tab 

6. check 'Disable Sound Blaster Enhancements' box 

// simple example 

Say ("Testing text to speech engine"); 

// helpful helper functions 

function SayOnce( text ) 

{ 

if ( StaticVarGetText ( "lastsaidtext" ) != text ) 

{ 

Say ( text ); 

StaticVarSetText ("lastsaidtext" , text ); 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


Say - speaks provided text 
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function SayNotTooOften( text, Minperiod ) 

{ 

elapsed=GetPerf ormanceCounter () /lOOO; 

Lastelapsed = Nz ( StaticVarGet ( "lastsaytime" ) ); 

if ( elapsed - Lastelapsed > Minperiod ) 

{ 

StaticVarSet (" lastsaytime" , elapsed ); 

Say ( text ); 

} 


SayOnce( "Testing "+Name() ); 

SayNotTooOften( "Say not more often than every 60 seconds", 60 ); 


SEE ALSO 
References: 

The Say function is used in the foiiowing formuias in AFL on-iine iibrary: 

• AutoTrade using an Expioration 

• Button trading using AB auto trading interface 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


Say- speaks provided text 
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Second 

- get current bar's second 


SYNTAX SecondO 

RETURNS ARRAY 

FUNCTION Retrieves current bar's second 

EXAMPLE Hour()*10000 + Minute() *100 + Second() 

SEE ALSO Hour(), MinuteQ, TimeNum() 

References: 

The Second function is used in the foiiowing formuias in AFL on-line library: 


• Export EOD or Intraday to .csv file 

• Export Intraday Data 

More information: 


Updated on-line reference 


Date/Time 

(AFL 2.0) 


Second - get current bar's second 


1000 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


SectorlD 

- get sector ID / name 


Information / Categories 

(AFL 1.8) 


SYNTAX SectorlD( mode = 0 ) 

RETURNS NUMBER/STRING 

FUNCTION Retrieves current stock sector ID/name When mode = 0 (the default value ) this function 
returns numerical sector ID (consecutive sector number) 

When mode = 1 this function returns name of the sector. 


EXAMPLE Filter = SectorlD() == 7 OR SectorlD() == 9; 

AddTextColumn( SectorlD( 1 ), "Sector name"); 

SEE ALSO 
References: 


The SectorlD function is used in the following formulas in AFL on-line library: 

• Compare Sectors against Tickers 

• Graphical sector stock amalysis 

• Steve Woods' Cum. Vol. Float + Cum. Vol. Channels 

• Steve Woods' Cumulative Vol. Percentage Indicator 

More information: 

Updated on-line reference 


SectorlD - get sector ID / name 
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SelectedValue 

- retrieves value of the array at currently selected date/time point 


Exploration / Indicators 

(AFL 2.1) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
Comments: 


SelectedValue( ARRAY) 

NUMBER 

Retrieves array value at currently selected bar. Main purpose: commentary and interpreration 
code. 

selectedvalue( close) 


Tomasz Janeczko 

tj -at- amibroker.com 
2003-05-11 06:02:38 

SelectedValue(array) is a function that retrieves 'selected element' of the array. 

Since 'selection line' is available only for CHARTS. SelectedValue gives 
the value of array at bar that is currently selected in chart by vertical line. 

This is how it works in INDICATORS, INTERPRETATION and CHART 
COMMENTARY 

(because they are relative to selected bar) 


In AA window 'selected element' means THE LAST BAR of currently selected 
analysis range. It is the last available bar for "all quotes" and "last n quotes" range. 

It is the the bar corresponding to "End Date" when using "From-To" range. 


So if you choose range: "all quotes" in AA 

SelectedValue function is equivalent to 


array[ BarCount - 1 ] 


References: 


The SelectedValue function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• Advanced MA system 

• Advanced Trend Lines with S & R 

• Advisory NRx price chart display. 

• Andrews Pitchfork 

• Andrews PitchforkV3.3 

• Aroon The Advisor 

• AR_Prediction.afl 

• Auto Trade Step by Step 

• Average Price Crossover 

• babaloo chapora 

• BEANS-Summary of Holdings 

• Bull/Bear Volume 

• Button trading using AB auto trading interface 

• Candle Identification 

• Candle Stick Demo 


SelectedValue - retrieves value of the array at currently selected date/time point 
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• CCI(20) Divergence Indicator 

• Chandeiier Exit 

• changing period moving average 

• Coior Dispiay.afi 

• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• Colorfull Price 

• Congestions detection 

• Coppock Trade Signal on Price Chart 

• Daily High Low in Advance 

• DateNumDateStr 

• Dave Landry PullBack Scan 

• DEBAJ 

• DiNapolis 3x Displaced Moving Averages 

• ekeko price chart 

• Elder safe Zone Long + short 

• Elder Triple Screen Trading System 

• Expiry day/days - Last thursday of month 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Fre 

• Frequency distribution of returns 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gann level plotter 

• Gann Swing Charts in 3 modes with text 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Harmonic Patterns 

• Heatmap V1 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• HH-LL-PriceBar 

• Hurst "Like" DE 

• ICHIMOKU SIGNAL TRADER 

• Intraday Fibonacii Trend Break System 

• Intraday Strength 

• Intraday Trend Break System 

• Inverted Plotted Volume Overlay Indicator 

• JEEVAN'S SRI CHAKRA 

• Luna Phase 

• LunarPhase 

• MS Darvas Box with Exploration 

• Multiple sinus noised 

• nifty 

• Option Calls, Puts and days till third friday. 

• PF Chart - Close - April 2004 

• Pivot End Of Day Trading System 

• Pivots And Prices 

• plot tomorrows pivots on an intraday database 

• Point & figure Chart India Securities 


SelectedValue - retrieves value of the array at currently selected date/time point 
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• prakash 

• Price Chart - Fundamental 

• Probability Density & Gaussian Distribution 

• PVT Trend Decider 

• Robert Antony 

• SAR-ForNextBarStop 

• Schiff Lines 

• shailu lunia 

• Square of Nine Roadmap Charts 

• Super Trend Indicator 

• suresh 

• TD Sequential 

• tomy_frenchy 

• TrendingRibbonArrowsADX 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Vikram's Floor Pivot Intraday System 

• Visible Min and Max Value Demo 

• William's Alligator System II 

• WILSON RELATIVE PRICE CHANNEL 

• Woodie's CCI Panel Full Stats 

• Zig Zag Indicator with Valid Entry and Exit Points 

• Zig-Hi Zap-Lo 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


SelectedValue- retrieves value of the array at currently selected date/time point 
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SendEmail 

- send an e-mail message 


Miscellaneous functions 

(AFL 3.90) 


SYNTAX SendEmail("subject", "message", ShowUI = False ) 

RETURNS NOTHING 

FUNCTION Send an e-mail to an address defined in the Preferences/Alert page. 

A direct version of functionality already provided by AlertIF. This function sends e-mail 
unconditionally and it is easier to use if you don't need state logic provided by Alertif. 

Note that "From" and "To" addresses as well as SMTP email configuration should be done in 
Tools->Preferences, "Alerts" page. Without configuring E-mail settings first this function will 
not work. 


E-mails are sent asynchronously (so function returns BEFORE e-mail is actually sent, 
sending occurs in the background) 

ShowUI parameter decides whenever user interface of e-mailer program is shown after 
sending e-mail or not. 

EXAMPLE SendEmail ( "This is subject", "Hello world\n\nHere we are sending 
the body of the email\n\nBest wishes" ); 

SEE ALSO AlertlfO function 

References: 


The SendEmail function is used in the following formulas in AFL on-line library: 

More Information: 


Updated on-line reference 


SendEmail - send an e-mail message 
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SetBacktestMode 

- Sets working mode of the backtester 


Trading system toolbox 

(AFL 3.0) 


SYNTAX SetBacktestMode( mode) 

RETURNS NOTHING 

FUNCTION Sets working mode of the backtester. A 'mode' parameter is one of the foiiowing backtest 
modes: 


Supported backtest modes: 

• backtestRegular - reguiar, signal-based backtest, redundant signals are removed 
as shown in this picture 

• backtestRegularRaw - signal-based backtest, redundant (raw) entry signals are 
NOT removed, only one position per symbol allowed 

• backtestRegularRawMulti - signal-based backtest, redundant (raw) entry signals 
are NOT removed, MULTIPLE positions per symbol will be open if BUY/SHORT 
signal is true for more than one bar and there are free funds, Sell/Cover exit all open 
positions on given symbol, Scale-ln/Out work on all open positions of given symbol 
at once. 

• backtestRegularRaw2 - for custom backtester users only, the same as 
backtestRegularRaw, but redundant exit signals are also kept. AVOID this mode - it 
requires lots of memory and slows everything down. 

• backtestRegularRaw2Multi - for custom backtester users only, same as 
backtestRegularRawMulti, but redundant exit signals are also kept. AVOID this mode 
- it requires lots of memory and slows everything down. 

• backtestRotational - rotational trading system see this. 

EXAMPLE // default, as in 4.90, regular, signal-based backtest, redundant 
signals are removed 

SetBacktestMode ( backtestRegular ) ; 

// signal-based backtest, redundant (raw) signals are NOT removed, 
only one position per symbol allowed 
SetBacktestMode ( backtestRegularRaw ); 

// signal-based backtest, redundant (raw) signals are NOT removed, 

// MULTIPLE positions per symbol will be open if BUY/SHORT signal is 
'true' for more than one bar and there are free funds 
// Sell/Cover exit all open positions on given symbol, Scale-In/Out 
work on all open positions of given symbol at once. 

SetBacktestMode ( backtestRegularRawMulti ) ; 

// rotational trading mode - equivalent of EnableRotationalTrading() 
call 

SetBacktestMode ( backtestRotational ) ; 

SEE ALSO EnableRotationalTradingO function 


SetBacktestMode - Sets working mode of the backtester 
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References: 

The SetBacktestMode function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Enveiope System 

• OBV with Linear Regression 

• Reverse MFI Crossover 

More information: 

Updated on-iine reference 


SetBacktestMode- Sets working mode of the backtester 
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SetBarFillColor 

- set bar/candlestick/cloud chart fill color 


Indicators 

(AFL 3.1) 


SYNTAX SetBarFillColor( colorarray) 

RETURNS NOTHING 

FUNCTION SetBarFillColor( colorarray ) allows to independently control candlestick, bar, cloud, and area 
chart fill color 


SetBarFillColor must PRECEDE the Plot() function call it applies to. 

when applied to: 

• styleCandle - SetBarFillColor controls the color of interior of candle body, shadows 
and outline is controlled by color passed in Plot statement 

• styleArea - SetBarFillColor controls the color of interior of histogram bars 

• styleBar - SetBarFillColor controls the color of the bar (H-L), open and close ticks 
color is controlled by Plot statement 

• styleCloud - SetBarFillColor controls the color of interior of the cloud, outline is 
controlled by color passed in Plot statement 

Other styles are not affected 

EXAMPLE SetBarFillColor ( IIf( MACD () >Signal ( ), colorYellow, colorBlue ) ); 

Plot ( C, "Price", IIf( C > O, colorGreen, colorRed ), styleCandle ) 

SEE ALSO PLOT() function 

References: 


The SetBarFillColor function is used in the following formulas in AFL on-line library: 


• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• Automatic Trendlines using multiple timeframes 

• Channel/S&R and trendlines 

• Colorfull Price 

• Fib Fan Based on ZZ 

• NASDAQ 100 Volume 

• Volume Occilator 

• ZLEMA ATR Long Only Trading System 


More Information: 


Updated on-line reference 


SetBarFillColor - set bar/candlestick/cloud chart fill color 
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SetBarsRequired 

- set number of previous and future bars needed for script/DLL to 
properly execute 


Miscellaneous 

functions 


(AFL 2.1) 


SYNTAX SetBarsRequired( backwardref = -1, forwardref = -1 ) 

RETURNS nothing 

FUNCTION set number of previous and future bars needed for script/DLL to properiy execute, if your 
formuia is pure AFL you don't need to use this function at aii, as AmiBroker automaticaiiy 
caicuiates number of bars required for aii its buiit-in functions. But if you are using script or a 

DLL you may need to use this function to make sure that your indicators are properiy 

caicuiated in QuickAFL mode. Specifying -1 means no change. For exampie if you are using 
the script that caicuiates 100 bar moving average you may need to caii SetBarsRequired( 
100, 0 ); at the very beginning of your formuia. Piease note that in most cases it is not 
necessary (even if you are using script or DLL) because AmiBroker aiways provides at ieast 
30 past data bars more than needed. Starting from AmiBroker version 5.20 you can use 
sbrAii (-2) constant to teii AmiBroker to use ALL avaiiabie bars: 


EXAMPLE SetBarsRequired( -2, -2 ); // require ALL past and future bars - this turns OFF quickAFL 
(V5.20) 


SEE ALSO 
References: 


The SetBarsRequired function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Adaptive Laguerre Fiiter, from John Ehiers 

• AFL Exampie 

• AFL Exampie - Enhanced 

• Andrews Pitchfork 

• Andrews PitchforkV3.3 

• AR_Prediction.afi 

• automatic trendiines using fractai patterns 

• Buiiish Percent index 2 fiies combined 

• Buiiish Percent index 2004 

• Chandeiier Exit 

• Congestions detection 

• Continuous Contract Roiiover 

• Cybernertic Fiiibert Sine Wave 

• DateNumDateStr 

• Dominant Cycie Phase 

• Ehiers Center of Gravity Osciiiator 

• Ehiers CyberCycie 

• Ehiers Dominant Cycie Period 

• Ehiers Fisher Transform 

• Ehiers instantaneous Trend 

• Ehiers Laguerre RSi 

• Export EOD or intraday to .csv fiie 

• Fre 

• Fiiibert Sine Wave Support & Resistance 


SetBarsRequired - set number of previous and future bars needed for script/DLL to properly exd<SiBS 
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• IBD relative strength database ranker 

• interactively test discretionary trading 

• Intraday Range and Periods Framer 

• JEEVAN'S SRI CHAKRA 

• Kagi Chart 

• Monthly bar chart 

• Multiple sinus noised 

• N Line Break Chart 

• Non-repaitning Zigzag line 

• P&F Chart - High/Low prices Sept2003 

• P&F chart with range box sizes 

• PF Chart - Close - April 2004 

• Prashanth 

• PVT Trend Decider 

• Random Walk 

• Renko Chart 

• Schiff Lines 

• Signal to Noise 

• Sine Wave Indicator 

• Sony 

• Square of Nine Roadmap Charts 

• Super Trend Indicator 

• Three Line Break - TLB 

• tomy_frenchy 

• Triangle exploration using P&F Chart 

• Triangular Moving Average new 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Volatility System 

• Volume Color with Dynamic Limit 

• VWAP versus Average Price 

• VWAP with standard deviation bands 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


SetBarsRequired- set number of previous and future bars needed for script/DLL toproperly exediBiO 
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SetChartBkColor 
- set background color of a chart 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


SetChartBkColor( color) 

NOTHING 

Sets chart background to user-specified coior 
SetChartBkCoior( coiorBiue ); 

CoiorHSBO function , CoiorRGB() function 


The SetChartBkColor function is used in the following formulas in AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Animated BackGround 

• Animated BackGround 1.1 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• Automatic Trendlines using multiple timeframes 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Price Crossover 

• Button trading using AB auto trading interface 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 
• DEBAJ 

• Fib Fan Based on ZZ 

• Fibonacci Internal and External Retracements 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Heatmap VI 

• Heinkin-Ashi 

• Hull Moving Average 

• JEEVAN'SSRI CHAKRA 

• Market Facilitation Index VS Volume 

• Point & figure Chart India Securities 

• Rebalancing Backtest avoiding leverage 

• SUPER PIVOT POINTS 

• Three Day Balance Point 

• VSTOP (2) 

• VSTOP (3) 

• VWAP versus Average Price 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 


Indicators 

(AFL 2.80) 


SetChartBkColor - set background color of a chart 
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• Woodie's Heikin-Ashi Panel 

• Woodie's Price Panel With Woodie's Pivots 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


SetChartBkColor- set background color of a chart 
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SetChartBkGradientFill 

- enables background gradient color fill in indicators 


Indicators 

(AFL 2.90) 


SYNTAX SetChartBkGradientFill( topcolor, bottomcolor, titlebkcolor = default, miny= Null, maxy 
= Null) 

RETURNS NOTHING 

FUNCTION Enables background gradient color fill in indicators. 

Please note that this is independent from chart background color (background color fills 
entire pane, gradient fill is only for actual chart interior, so axes area is not affected by 
gradient fill) 


• topcolor - specifies top color of the gradient fill 

• bottomcolor - specifies bottom color of the gradient fill 

• titlebkcolor - (optional) the background color of title text. If not specified then top color 
is automatically used for title background. 

• miny, maxy - (optional, new in 5.30) - allows gradient area charts in combination with 
cloud style (see example 2 below) 

EXAMPLE Example 1 : basic background gradient 


SetChartBkGradientFill ( ParamColor ("BgTop", 

colorWhite) , ParamColor ("BgBottom", colorLightYellow)); 

Example 2: area gradient chart 

function PlotGradientArea( array, caption, ColorTop, ColorBottom ) 
{ 

bkclr = GetChartBkColor (); 


HH = HighestVisibleValue ( array ) ; 

if ( NOT IsNull ( hh ) ) SetChartBkGradientFill ( ColorTop, 

ColorBottom, bkclr. Null, HH ); 

Plot ( array. Caption, ColorBlend( ColorBottom, colorBlack ) ); 

PlotOHLC ( HH, HH, array, HH, bkclr, styleNoLabel | styleNoTitle 

I styleCloud, Null, Null, 0, -10 ); 

} 


_SECTION_BEGIN ("Price") ; 

SetChartOptions (0, chartShowArrows|chartShowDates); 

_N (Title = StrFormat ("{{NAME}} - {{INTERVAL}} {{DATE}} Open %g. Hi 
%g, Lo %g. Close %g (%.lf%%) {{VALUES}}", O, H, L, C, SelectedValue ( 
ROC ( C, 1 ) ) ) ) ; 

PlotGradientArea ( C, "Close", ParamColor ( "Top" , colorLightOrange), 
ParamColor ( "Bottom" , colorPaleGreen ) ); 


_SECTION_END () ; 

SEE ALSO PLOT() function , PLOTFOREIGN() function , PLOTGRID() function , PLOTOHLC() function , 
PLOTSHAPESO function , PlotText() function , PLOTVAPOVERLAY() function 


SetChartBkGradientFill - enables background gradient color fill in indicators 
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References: 

The SetChartBkGradientFill function is used in the foiiowing formuias in AFL on-iine iibrary: 

• ALJEHANI 

• Average Price Crossover 

• CoinToss ver 1 

• Coppock Trade Signai on Price Chart 

• Coppock Trade Signai v1.1 

• DEBAJ 

• Fib Fan Based on ZZ 

• Fibonacci Internai and Externai Retracements 

• Future Piotting of Time and Price 

• Future Piotting of Time and Price 

• Fleinkin-Ashi 

• JEEVAN'S SRI CHAKRA 

• Jesse Livermore Secret Market Key 

• Lunar Phases - originai 

• LunarPhase 

• Piot visuai stop / target ratio. 

• Probabiiity Density & Gaussian Distribution 

• RSI + Avgs 

• RSI indicator with Upper & Lower Zone Bars 

• Square of Nine Roadmap Charts 

• TD Sequentiai 

• Three Day Baiance Point 

• TRENDAdvisor 

• Voiume Occiiator 

• WILSON RELATIVE PRICE CHANNEL 
More information: 

Updated on-line reference 


SetChartBkGradientFill- enables background gradient color fill in indicators 
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SetChartOptions 

- set/clear/overwrite defaults for chart pane options 


Exploration / Indicators 

(AFL 2.70) 


SYNTAX SetChartOptions( Mode = 0, Flags = 0, gridFlags = chartGridMiddle, ymin = 0, ymax = 
0, blankbars = 0 ) 

RETURNS NOTHING 

FUNCTION Allows to set/clear/overwrite/set defaults for chart pane options 


• Mode - specifies how options are set: 

♦ 0 - set oniy the DEFAULT vaiues for new chart. Defauits are appiied oniy 
once when chart is inserted in a new pane, so iater you can modify any 
option using Indicator Buiider 

♦ 1 - overwrite - the vaiues specified in 2nd and 3rd argument overwrite any 
previousiy set vaiues 

♦ 2 - set fiag - fiags specified in 2nd and 3rd parameter are binary-ORed with 
the current vaiues, so effectiveiy these options are set whiie remaining are 
unchanged 

♦ 3 - reset fiag - fiags specified in 2nd and 3rd parameter are cieared whiie the 
others remain unchanged. 

• Fiags - aiiowabie fiags are: 

chartShowDates, chartLogarithmic, chartShowArrows, chartWrapTitie (4.75 or 
higher), chartHideQuoteMarker (v5.06). chartHideQuoteMarker - hides the quote 
seiector iine on per-pane basis, the same as Parameter diaiog -> Axes & Grid -> 
Vert, quote marker: Show/Hide, chartDisabieYAxisCursor (new in 5.80) - disabies 
changing mouse pointer to up/down arrow when hovering above Y axis, 
chartDisabieTooitips (new in 5.80) - disabies dispiaying tooitips (data tips). 

• gridFiags - (for internai AmiBroker use - do not use it in your own coding as this 
parameter wiii be eventuaiiy removed) aiiowabie vaiues are: chartGridDivlOO, 
chartGridPercent, chartGridDivlOOO, chartGridMargins chartGridMiddie, chartGridO, 
chartGrid30, chartGrid70, chartGridIO, chartGridOO, 
chartGrid50,chartGrid100,chartGrid20,chartGrid80,chartGrid1 

• ymin, ymax - (new in 5.07) these parameters specify Y-axis minimum and maximum 
vaiues for custom scaiing. If you specify any vaiues that meet the condition ymin < 
ymax, AmiBroker wiii turn OFF automatic scaiing and use specified min/max vaiues 
for Y scaie. Note that Mode argument controis when these settings are appiied (0 - 
oniy when new chart is created, 1 - aiways), when modes 2 and 3 are used - scaiing 
is not changed. 

• biankbars - (new in 5.30) defines the minimum number of biank bars for given chart. 
The defauit vaiue of zero means no change (use preferences setting). 

If specified vaiue is iess than vaiue set in preferences, it is ignored, so you can not 
decrease the biank bars beiow vaiue set in preferences. 

If many panes within same chart use this function, then the iargest specified 
biankbars wiii be used 


Note that you can stiii extend biank space further using END key. Speciai feature - if 
"biankbars" is negative then extra biank bars added are equai to absoiute vaiue of 
biankbars parameter pius chart gets scroiied to rightmost position. 


SetChartOptions - set/clear/overwrite defaults for chart pane options 
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Caveat: forcing custom blankbars via SetChartOptions effectiveily disables HOME 
key scroll to begin operation. 

EXAMPLE //t o mark "Show arrows" by default in a new chart use 

SetChartOptions ( 0, chartShowArrows ); 

Example 2 (works only with version 4.75 or higher): 

SetChartOptions (2, chartWrapTitle ); 

Title="this is a test of automatic wrapping of title text that is 
too long to fit in single line, for that reason this sample formula 
uses very long text. I hope you are enjoying the sample"; 

SEE ALSO 
References: 

The SetChartOptions function is used in the following formulas in AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Advanced MA system 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Price Crossover 

• babaloo chapora 

• Button trading using AB auto trading interface 

• changing period moving average 

• Channel/S&R and trendlines 

• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• Colorfull Price 

• Coppock Trade Signal on Price Chart 

• Daily High Low in Advance 

• Dave Landry PullBack Scan 

• DEBAJ 

• Dinapoli Perferred Stochastic 

• Elder Triple Screen Trading System 

• Fib Fan Based on ZZ 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gann level plotter 


SetChartOptions- set/clear/overwrite defaults for chart pane options 
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• Gann Swing Charts in 3 modes with text 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• HH-LL-PriceBar 

• IB Backfiiier 

• ICHIMOKU SIGNAL TRADER 

• Intraday Fibonacii Trend Break System 

• Intraday Strength 

• Intraday Trend Break System 

• Kairi Relative Index 

• Last Five Trades Result Dashboard - AFL code 

• Lunar Phases - original 

• LunarPhase 

• Market Profile 

• MS Darvas Box with Exploration 

• N Line Break Chart 

• nifty 

• Non-repaitning Zigzag line 

• Pivots And Prices 

• plot tomorrows pivots on an intraday database 

• prakash 

• Price Chart - Fundamental 

• Rebalancing Backtest avoiding leverage 

• RSI styleClipMinMax 

• shailu lunia 

• Square of Nine Roadmap Charts 

• Super Trend Indicator 

• suresh 

• TrendingRibbonArrowsADX 

• VSTOP (2) 

• VSTOP (3) 

• VWAP versus Average Price 

• William's Alligator System II 

• Woodie's CCI Panel Full Stats 

• ZigZag filter rewrited from scratch in AFL 

• ZigZag Hi Lo Barcount 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


SetChartOptions- set/clear/overwrite defaults for chart pane options 
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SetCustom BacktestProc 
- define custom backtest procedure formula file 


Trading system toolbox 

(AFL 2.70) 


SYNTAX SetCustomBacktestProc( filename, enable = True ) 

RETURNS NOTHING 

FUNCTION This function aiiows changing custom backtest procedure fiie from AFL formuia ievei. 
To iearn more about custom backtester procedures piease read this document. 
Parameters 


• filename parameter instructs backtester to use externai formuia file as custom 
backtest procedure, if empty - it means use current formula 

• enable = True (default) - enables custom backtesting procedure (the same as 
SetOption("UseCustomBacktestProc", True); 

enable = False - disables custom proc 

EXAMPLE SetCustomBacktestProc ( "Formulas\MyCustomBacktest.af 1" , True ); 

SEE ALSO 
References: 


The SetCustomBacktestProc function is used in the following formulas in AFL on-line library: 

• Customised Avg. Profit %, Avg. Loss % etc 

• Detailed Equity Curve 

• MFE and MAE and plot trades as indicator 

• Rebalancing Backtest avoiding leverage 

More Information: 


Updated on-line reference 


SetCustomBacktestProc - define custom backtest procedure formula file 
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SetForeign 

- replace current price arrays with those of foreign 


Referencing other symbol 
data 

(AFL 2.5) 


security 

SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


SEE ALSO 


SetForeign( ticker, fixup = True, tradeprices = Faise} 

NUMBER 

The SetForeign function replaces current price/volume arrays with those of foreign security, 
returns True (1) if ticker exists, False (0) otherwise. 

If ticker does not exist (and function returns false) price arrays are not changed at all. 

fixup parameter controls if data holes are filled with previous bar data or not. If fixup is False 
then data holes are filled with Null value. For detailed discussion on fixup parameter please 
check Foreign function. 

tradeprices parameter controls if trade price arrays should be replaced too. If it is set to 
TRUE, then not only OHLC, V, Ol, Avg arrays are set to foreign symbol values, but also 
BuyPrice, SellPrice, ShortPrice, CoverPrice, PointValue, TickSize, RoundLotSize, 
MarginDeposit variables are set to correspond to foreign security. This allows EquityO to 
work well with SetForeign. 

Single SetForeign( "ticker" ) call is equivalent to the following sequence: 

C = Foreign ( "ticker", "C" ); 

O = Foreign ( "ticker", "0" ); 

H = Foreign ( "ticker", "H" ); 

L = Foreign ( "ticker", "L" ); 

V = Foreign ( "ticker", "V" ); 

01 = Foreign ( "ticker", "I" ); 

Avg = (CtH+L)/3; 

but 6x faster (SetForeign takes about the same time as single foreign). To restore original 
prices call RestorePriceArrays() 

// Example 1: Plot the indicator using foreign security data 
SetForeign ( "MSFT" ); 

Plot ( Ultimate 0, "Ultimate from MSFT", colorRed ); 
RestorePriceArrays (); 

// Example 2: Use SetForeign with Equity function 
SetForeign ( "MSFT" , True, True ); 

Buy = Cross ( MACD (), Signal ()); 

Sell = Cross ( Signal (), MACD ()); 
e = EquityO; // backtest on MSFT 
RestorePriceArrays ( True ); // 

FOREIGNO function , RestorePriceArrays() function 


security 

SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


SEE ALSO 


SetForeign - replace current price arrays with those of foreign security 
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References: 

The SetForeign function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Bad Tick Trim on 5 sec database 

• BEANS-Summary of Floidings 

• Continuous Contract Roiiover 

• Graphicai sector anaiysis 

• Graphicai sector stock amaiysis 

• Fleatmap V1 

• IBD reiative strength database ranker 

• Improved NH-NH scan / indicator 

• Ranking and sorting stocks 

• Ranking Ticker WatchList 

• Stress with SuperSmoother 

• WLBuiidProcess 

More information: 

Updated on-line reference 


SetForeign- replace current price arrays with those of foreignsecurity 
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SetFormulaName 
- set the name of the formula 


Trading system toolbox 

(AFL 2.5) 


SYNTAX SetFormulaName( string) 

RETURNS NOTHING 

FUNCTION Allows to programatically change the name of the formula that is displayed in the backtest 
result explorer. 


EXAMPLE SetFormulaName ( "My Holy Grail System"); 

SEE ALSO 
References: 


The SetFormulaName function is used in the following formulas in AFL on-line library: 

• AFL Example 

• AFL Example - Enhanced 

• Triangular Moving Average new 

More information: 


Updated on-line reference 


SetFormulaName - set the name of the formula 
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SetGradientFill 

- set the colors of a gradient fill plot 


Indicators 

(AFL 3.60) 


SYNTAX SetGradientFill( topcolor, bottomcolor, baseline = Null, baselinecolor = -1 ) 
RETURNS NOTHING 


FUNCTION The function defines coiors for gradient area charts. Gradient chart is obtained using 

styieGradient in the Piot() function caii. Upper gradient coior is specified by topcoior, bottom 
gradient coior is specified by botttomcoior. Optionai parameters (baseiine/baseiinecoior) 
aiiow reverse gradient chart (such as underwater equity) and 3 coior gradients 
top->baseiine->bottom. See code for Underwater Equity for exampie usage of reverse 
gradient chart (with baseiine at the top). Baseiine parameter specifies the Y-axis position of 
chart baseiine. The baseiinecolor parameter specifies the color of gradient that is to be used 
at that level. If baselinecolor is not specified, then only 2-color gradient is plotted 
(topcolor->bottomcolor). 

EXAMPLE // Underwater Equity chart 
// (C)2009 AmiBroker.com 

// Should be used only on -EQUITY or -OSEQUITY symbol 


EQ = C; 

MaxEQ = Highest ( EQ ); 

DD = 100 * ( Eq - MaxEQ ) / MaxEq; 

MaxDD = Lowest ( DD ); 


Title = StrFormat ( "Drawdown = %.2g%%. Max. drawdown %.2g%%", DD, 
LastValue ( MaxDD ) ); 

SetGradientFill ( GetChartBkColor () , colorBlue, 0 ); 

Plot ( DD, "Drawdown ", colorBlue, styieGradient | styleLine ); 
Plot ( MaxDD, "Max DD", colorRed, styleNoLabel ); 

SetChartOptions ( 2, 0, chartGridPercent ) ; 

if( NameO != "-EQUITY" AND Name () != "-OSEQUITY" ) Title = 

"Warning: wrong ticker! This chart should be used on -EQUITY or 

-OSEQUITY only"; 

SEE ALSO Plot() function 

References: 

The SetGradientFill function is used in the following formulas in AFL on-line library: 


• Stress with SuperSmoother 


SetGradientFill - set the colors of a gradient fill plot 
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More information: 

Updated on-line reference 


SetGradientFill- set the colors of a gradient fill plot 
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SetOption 

- sets options in automatic anaiysis settings 

SYNTAX SetOption( field, value ) 

RETURNS NOTHING 

FUNCTION Sets various options in automatic anaiysis settings. Affects aiso EquityO function resuits. 

field- is a string that defines the option to change. There are foiiowing options avaiiabie: 

• "NoDefauitCoiumns" - if set to True - expioration does not have defauit Ticker and 
Date/Time coiumns 

• "InitiaiEquity" 

• "AiiowSameBarExit" 

• "ActivateStopsImmediateiy" 

• "AiiowPositionShrinking" 

• "FuturesMode" 

• "InterestRate" 

• "MaxOpenPositions" - maximum number of simiutaneousiy open positions (trades) in 
portfoiio backtest/optimization 

• "WorstRankHeid" - the worst rank of symboi to be heid in rotationai trading mode 
(see EnableRotationalTrading for more detaiis) 

• "MinShares" - the minimum number of shares required to open the position in the 
backtester/optimizer. If you don't have enough funds to purchase that many, trade 
will NOT be entered 

• "MinPosValue" - (4.70.3 and above) the minimum dollar amount required to open the 
position in the backtester/optimizer. If you don't have enough funds trade will NOT be 
entered 

• "PriceBoundChecking" - if set to False - disables checking and adjusting 
buyprice/sellprice/coverprice/shortprice arrays to current symbol High-Low range. 

• CommissionMode - 

0 - use portfolio manager commission table 

1 - percent of trade 

2 - $ per trade 

3 - $ per share/contract 

• CommissionAmount - amount of commission in modes 1 ..3 

• AccountMargin (in old versios it was 'MarginRequirement') - account margin 
requirement (as in settings), 100 = no margin 

• ReverseSignalForcesExit - reverse entry signal forces exit of existing trade (default = 
True ) 

• UsePrevBarEquityForPosSizing - Affects how percent of current equity position 
sizing is performed. 

False (default value) means: use current (intraday) equity to perform position sizing. 
True means: use previous bar closing equity to perform position sizing 

• PortfolioReportMode - sets backtester report mode: 

0 - trade list 

1 - detailed log 

2 - summary 

3 - no output (custom only) 


Trading system toolbox 

(AFL 2.3) 


SetOption - sets options in automatic analysis settings 
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• UseCustomBacktestProc - True/False - allows to turn on/off custom backtest 
procedure 

• EveryBarNullCheck - allows to turn on checking for Nulls In arithmetic operations on 
every bar In the array(by default It Is OFF - I.e. AmiBroker checks for nulls that 
appear In the beginning of the arrayand In the end of the array and once non-null 
value Is detected It assumes no further holes (nulls) In the middle). Turning 
"EveryBarNullCheck" to True allows to extend these checks to each and every 
barwhich Is the way 4.74.x and earlier versions worked. 

Note however that turning It on gives huge performance penalty (arithmetic 
operations are performed even 4x slower when this option Is ON, so don't use It 
unless you really have to). 

• HoldMInBars - Number - If set to value > 0 - It disables exit during user-specified 
number of bars even If signals/stops are generated during that period 

• EarlyExItBars - Number If set to value > 0 - causes that special early exit 
(redemption) fee Is charged If trade Is exited during this period 

• EarlyExItFee - defines the % (percent) value of early exit fee 

• HoldMInDays - Number - If set to value > 0 - It disables exit during user-specified 
number of CALENDAR DAYS (not bars) even If signals/stops are generated during 
that period 

• EarlyExltDays - Number If set to value > 0 - causes that special early exit 
(redemption) fee Is charged If trade Is exited during the period specified In calendar 
days (not bars). 

• DIsableRulnStop - It set to TRUE bullt-ln ruin stop Is disabled 

• Generate report - allows to suppress/force generation of backtest report. Allowable 
values: 0, 1, or 2 

By default backtest reports are generated ONLY for portfolio backtests and for 
Individual backtests If Individual reporting Is turned on In the settings. Reports are 
disabled for optimization. 

Now with the SetOptlon() function you can either supress report generation for 
backtests or enable report generation during certain optimization steps, all from code 
level. 

SetOptlon("GenerateReport", 0 ); // suppress generation of report 
SetOptlon("GenerateReport", 1 ); // force generation of full report 
SetOptlon("GenerateReport", 2 ); // only one-llne report Is generated (In results.rist 
file) viewable as single line In Report Explorer 

• SeparateLongShortRank - True/False 

When separate long/short ranking Is enabled, the backtester maintains TWO 
separate "top-ranked" signal lists, one for long signals and one for short signals. This 
ensures that long and short candidates are Independently even If position score Is 
not symetrical (for example when long candidates have very high positive scores 
while short candidates have only fractional negative scores). That contrasts with the 
default mode where only absolute value of position score matters, therefore one side 
(long/short) may completely dominate ranking If score values are asymetrical. 

When SeparateLongShortRank Is enabled. In the second phase of backtest, two 
separate ranking lists are Interleaved to form final signal list by first taking top ranked 
long, then top ranked short, then 2nd top ranked long, then 2nd top ranked short, 
then 3rd top ranked long and 3rd top ranked short, and so on... (as long as signals 
exist In BOTH long/short lists. If there Is no more signals of given kind, then 
remaining signals from either long or short lists are appended) 

For example: Entry slgnals(score):ESRX=Buy(60.93), GILD=Short(-47.56), 
CELG=Buy(57.68), MRVL=Short(-10.75), ADBE=Buy(34.75), VRTX=Buy(15.55), 
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SIRI=Buy(2.79), 

As you can see Short signals get interleaved between Long signals even though 
their absolute values of scores are smaller than corresponding scores of long 
signals. Also there were only 2 short signals for that particular bar so, the rest of the 
list shows long signals in order of position score 

Although this feature can be used independently, it is intended to be used in 
combination with MaxOpenLong and MaxOpenShort options. 

• MaxOpenLong - limits the number of LONG positions that can be open 
simultaneously 

• MaxOpenShort - limits the number of SHORT positions that can be open 
simultaneously 

The value of ZERO (default) means NO LIMIT. If both MaxOpenLong and 
MaxOpenShort are set to zero ( or not defined at all) the backtester works old way - 
there is only global limit active (MaxOpenPositions) regardless of type of trade. 

Note that these limits are independent from global limit (MaxOpenPositions). This 
means that MaxOpenLong + MaxOpenShort may or may not be equal to 
MaxOpenPositions. 

If MaxOpenLong + MaxOpenShort is greater than MaxOpenPositions then total 
number of positions allowed will not exceed MaxOpenPositions, and individual 
long/short limits will apply too. For example if your system MaxOpenLong is set to 7 
and maxOpenShort is set to 7 and MaxOpenPositions is set to 10 and your system 
generated 20 signals: 9 long (highest ranked) and 11 short, it will open 7 long and 3 
shorts. 

If MaxOpenLong + MaxOpenShort is smaller than MaxOpenPositions (but greater 
than zero), the system won't be able to open more than 
(MaxOpenLong+MaxOpenShort). 

Please also note that MaxOpenLong and MaxOpenShort only cap the number of 
open positions of given type (long/short). They do NOT affect the way ranking is 
made. I.e. by default ranking is performed using ABSOLUTE value of positionscore. 
If your position score is NOT symetrical, this may mean that you are not getting 
desired top-ranked signals from one side. Therefore, to fully utilise MaxOpenLong 
and MaxOpenShort in rotational balanced ("market neutral") long/short systems it is 
desired to perform SEPARATE ranking for long signals and short signals. 

To enable separate long/short ranking use: 

SetOption("SeparateLongShortRank", True ); 

• RefreshWhenCompleted - when set to TRUE, it will perform View->Refresh All after 
Automatic-Analysis operation (scan/exploration/backtest/optimize) is completed. 

• RequireDeclarations - when set to TRUE the AFL engine will always require variable 
declarations (using local/global) on formula-by-formula basis 

• ExtraColumnsLocation - allows the user to change the location of custom columns 
added during backtest/optimization. 

"extra" columns mean: 

a) any custom metrics added using custom backtester 

b) any optimization parameters defined using Optimize() function 

If both custom metrics and optimization parameters are present then custom metrics 
appear first then optimization parameters 

This function is provided to allow the user to change the default "at the end" location 
of custom columns/optimization parameters. 

For example: 
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SetOption("ExtraColumnsLocation", 1 ); 

will cause that custom metrics and opt params will be subsequently added starting 
from column 1 (as opposed to last column default) 

Note that this setting changes "visual" order of columns, not really in-memory order 
or export order, so exported data files or copy/paste format do not change. 

• SettlementDelay - this option describes the number of days (not bars) it takes for 
sale proceeds to settle and be available for opening new positions. 

SetOption("SettlementDelay", 3 ); // this will cause that proceeds from sale are only 
available for trading on 3rd day after sale 

For detailed tracking " Detailed log" report option now shows available and unsettled 
funds for T-i-1, T-i-2 and so on 

Note: when using this option it is recommended to use backtestRegularRaw instead 
of backtestRegular, otherwise some trades may not be entered because funds are 
not settled immediately and you need to be able to enter not on first but subsequent 
buy signals and that is exactly what backtestRegularRaw offers. 

Note2: old backtester (EquityO function) ignores settlement delay 

• StaticVarAutoSave - allow periodical auto-saving of persistent static variables (in 
addition to saving on exit, which is always done). 

The interval is given in seconds. 

For example: 

SetOption("StaticVarAutoSave", 60 ); // auto-save persistent variables every 60 
seconds (1-minute) 

It is important to understand that persistent variables are saved ON EXIT 
automatically, without any user intervention so it should be enough for most cases. If 
you for some reason want auto-saves when AmiBroker is running, then you can use 
this function. Please note that writing many static variables into physical disk file 
takes time and it blocks all static variable access so you should AVOID specifying 
too small auto-save intervals. Saving every second is bad idea - it will cause 
overload. Saving every 60 seconds should be fine. Calling function with interval set 
to zero disables auto-save. 

SetOption("StaticVarAutoSave", 0); 

• MCEnable - controls Monte Carlo simulation: 0 - disabled, 1 - enabled in backtests, 2 
- enabled in backtests and optimizations 

• MCRuns - number of Monte Carlo simulation runs (realizations) default 1000 

• MCPosSizeMethod - Monte Carlo position size method: 0 - don't change, 1 - fixed 
size, 2 - constant amount, 3 - percent of equity 

• MCPosSizeShares - number of shares per trade in MC simulation 

• MCPosSizeValue - dollar value per trade in MC simulation 

• MCPosSizePctEquity - percent of current equity per trade in MC simulation 

• MCChartEquityCurves - true/false (1/0) - enables Monte Carlo equity chart 

• MCStrawBroomLines - defines number of equity lines drawn in Monte Carlo straw 
broom chart 

• WarningLevel - allows to change warning level. Level 1 is default for all AFL 
executions with exception of AFL editor and commentary where warning level is set 
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to 4 

Warning Level 

1 - report only level 1 warnings (502- too much plots) 

2 - report level 1 and 2 warnings (above plus assignment within conditional, division 
by zero, threadsleep period too long) 

3 - report level 1,2 and 3 warnings (above plus createobject/createstaticobject) 

4- report all warnings (default for the AFL editor) 

WARNING: If you change the option on *per-symbol* basis the composite results 
(%proflt for example) will be DISTORTED since calculations assume that OPTIONS are 
constant for all symbols In one backtest run. 'HoldMInBars', 'EarlyExIt..." options are 
exception from this rule (I.e. can be safely set on per-symbol basis) 

EXAMPLE SetOption ( " InitialEquity " , 5000 ); 

SetOption ( "AllowPositionShrinking" , True ); 

SetOption ( "MaxOpenPositions" , 5 ); 

PositionSize = -100/5; 

SEE ALSO EnableRotationalTradingO function , EQUITY() function 

References: 

The SetOption function is used in the foliowing formulas in AFL on-line library: 

• AFL Example 

• AFL Example - Enhanced 

• Black Scholes Option Pricing 

• CoinToss ver 1 

• Connors TPS 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• End Of Year Trading 

• Envelope System 

• IBD relative strength database ranker 

• Kelly criterion 

• Last Five Trades Result Dashboard - AFL code 

• MFE and MAE and plot trades as indicator 

• OBV with Linear Regression 

• Perceptron 

• Plot the Equity Curve without Backtesting? 

• PVT Trend Decider 

• Ranking and sorting stocks 

• Rebalancing Backtest avoiding leverage 

• Relative Strength 

• Reverse MFI Crossover 

• RUTVOL timing signal with BB Scoring routine 

• Scale Out: Futures 

• Simple Candle Exploration 

• Sine Wave Indicator 

• suresh 

• testing multiple system simulataneously 

• Trend Exploration: Count Number of New Highs 

• Trend Exploration: Slope Moving Average 
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• Trend Following System 

• Triangular Moving Average new 

• Visualization of stoploses and profit in chart 

• Volatility System 

More information: 

Updated on-line reference 
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SetPositionSize 
- set trade size 


Trading system toolbox 

(AFL 2.70) 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


SetPositionSize( size, method) 

ARRAY 

This function aiiows to controi trade (position) size in four different ways, depending on 
'method' parameter. 

Parameters: 

size (ARRAY) defines desired trade size 
method (ARRAY) defines how 'size' is interpreted 

• spsVaiue (=1) - doiiar vaiue of size (as in previous versions) 

• spsPercentOfEquity (=2) - size expressed as percent of portfoiio-ievei equity (size 
must be from ..100 (for reguiar accounts) or .1000 for margin accounts) 

• spsShares (=4) - size expressed in shares/contracts (size must be > 0 ) 

• spsPercentOfPosition (=3) - size expressed as percent of currentiy open position (for 
SCALiNG iN and SCALiNG OUT ONLY) 

• spsNoChange (=0) - don't change previousiy set size for given bar 

New SetPositionSize function automaticaiiy encodes new methods of expressing position 
size into oid "positionsize" variabie as foiiows: 

• vaiues beiow -2000 encode share count, 

• vaiues between -2000 and -1000 encode % of current position 

• vaiues between -1000 and 0 encode % of portfoiio equity 

• vaiues above 0 encode doiiar vaiue 

Aithough it is possibie to assign these vaiues directiy to oid-styie PositionSize variabie, new 
code shouid use SetPositionSize function for ciarity. 

For exampie to iiquidate 50% of position simpiy use 

SetPositionSize ( 50, spsPercentOfPosition * ( Buy == sigScaleOut ) 


Speciai vaiue spsNoChange (=0) means don't change previousiy set size for given bar 
(aiiows to write constructs iike that): 

SetPositionSize! 100, spsShares ); // 100 shares by default 
SetPositionSize! 50, Ilf! Buy == sigScaleOut, spsPercentOfPosition, 
spsNoChange ) ); // for scale-out use 50% of current position size 

Exampie of code that exits 50% on first profit target, 50% on next profit target and everything 
at traiiing stop: 

Buy = Cross! MA! C, 10 ), MA! C, 50 ) ) ; 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 
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Sell = 0; 

// the system will exit 

// 50% of position if FIRST PROFIT TARGET stop is hit 
// 50% of position is SECOND PROFIT TARGET stop is hit 
// 100% of position if TRAILING STOP is hit 

FirstProfitTarget = 10; // profit 
SecondProfitTarget = 20; // in percent 
TrailingStop = 10; // also in percent 

priceatbuY=0; 
highsincebuy = 0; 

exit = 0; 

for ( i = 0; i < BarCount; i++ ) 

{ 

if ( priceatbuy == 0 AND Buy [ i ] ) 

{ 

priceatbuy = BuyPrice [ i ]; 

} 

if ( priceatbuy > 0 ) 

{ 

highsincebuy = Max ( High [ i ], highsincebuy ); 
if ( exit == 0 AND 

High [ i ] >= ( 1 + FirstProfitTarget * 0.01 ) * priceatbuy 


// first profit target hit - scale-out 
exit = 1; 

Buy[ i ] = sigScaleOut; 


if ( exit == 1 AND 

High [ i ] >= ( 1 + SecondProfitTarget * 0.01 ) * 

priceatbuy ) 

{ 

// second profit target hit - exit 
exit = 2; 

SellPrice [ i ] = Max ( Open [ i ], ( 1 + SecondProfitTarget * 

0.01 ) * priceatbuy ); 

} 


if ( Low [ i ] <= ( 1 - TrailingStop * 0.01 ) * highsincebuy ) 

{ 

// trailing stop hit - exit 
exit = 3; 

SellPrice [ i ] = Min ( Open[ i ], ( 1 - TrailingStop * 0.01 
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) * highsincebuy ); 

} 

if ( exit >= 2 ) 

{ 

Buy[ i ] = 0; 

Sell [ i ] = exit +1; // mark appropriate exit code 
exit = 0; 

priceatbuy = 0; // reset price 
highsincebuy = 0; 

} 

} 

} 

SetPositionSize ( 50, spsPercentOfEquity ); 

SetPositionSize ( 50, spsPercentOfPosition * ( Buy == sigScaleOut ) 

); // scale out 50% of position 


SEE ALSO 
References: 

The SetPositionSize function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Connors TPS 

• Customised Avg. Profit %, Avg. Loss % etc 

• Ed Seykota's TSP: EMA Crossover System 

• Last Five Trades Resuit Dashboard - AFL code 

• Piot the Equity Curve without Backtesting? 

• Scaie Out: Futures 

• testing muitipie system simuiataneously 

• Trend Foiiowing System 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 
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SetSortColumns 

- sets the columns which will be used for sorting in AA window 


Exploration / Indicators 

(AFL 2.90) 


SYNTAX SetSortColumns( col1, col2,....) 
RETURNS NOTHING 


FUNCTION sets the columns which will be used for sorting. coH, col2, ... coHO -Column numbers are 
ONE-based. Positive number means sort ASCENDING, negative number means sort 
DESCENDING. Upto 10 columns can be specified for multiple-column sort. Each subsequent 
call to SetSortColumns overwrites previous one, but multiple SetSortColumns make sense if 
you want to add multiple rankings by different columns via AddRankColumn 

EXAMPLE // sort by 5th column in ascending order 
SetSortColumns ( 5 ) 


// sort by 3rd column in descending order 
SetSortColumns ( -3 ) 

// sort by 1st column in ascending order AND then by Second column 
in descending order (multiple-column sort). 

SetSortColumns! 1, -2 ); 

SEE ALSO AddRankColumnO function 

References: 


The SetSortColumns function is used in the following formulas in AFL on-line library: 

• Commodity Selection Index (CSI) 

• Stress with SuperSmoother 

• Trend Exploration: Count Number of New Highs 

More Information: 


Updated on-line reference 
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SetStopPrecedence 
- set precedence of built-in stops 


Trading system toolbox 

(AFL 4.0) 


SYNTAX SetStopPrecedence( typel, type2, typeS, type4 ) 
RETURNS NOTHING 


FUNCTION SetStopPrecedence defines the order in which stops are executed in case many stops 
trigger on the very same bar, as in exampie given beiow. SetStopPrecedence shouid be 
caiied AFTER AppiyStop() functions. 

EXAMPLE // first execute N-bar stop, then max loss, then trailing, then 
profit 


SetStopPrecedence ( stopTypeNBar, stopTypeLoss, stopTypeTrailing, 
stopTypeProfit ); 

SEE ALSO AppiyStopO function 

References: 

The SetStopPrecedence function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-line reference 


SetStopPrecedence - set precedence of built-in stops 
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SetTradeDelays 

- allows to control trade delays applied by the backtester 


Trading system toolbox 

(AFL 2.1) 


SYNTAX SetTradeDelays( buydelay, selldelay, shortdelay, coverdelay) 

RETURNS nothing 

FUNCTION Sets trade delays applied by the backtester. This function allows you to override trade delays 

from the "Settings" page. It is important do understand what trade delays really do. They in 
fact internally apply the following: 


Buy = Ref( Buy, -buydelay ); 

Sell = Ref( Sell, -selldelay ); 

Short = Ref( Short, -shortdelay ); 

Cover = Ref( Cover, -coverdelay ); 

inside backtester after your formula is executed but before backtester starts trade simulation 
It is functionally equivalent to having above 4 lines at the end of your formula. Note that NO 
OTHER variables are affected by trade delays, therefore for example if your position sizing 
depends on values found in buy/sell/short/cover variables *and* if you are using non-zero 
trade delays you need to account for that in your code. 

EXAMPLE settradedelays( 1, 1, 1, 1 ) 

SEE ALSO 
References: 


The SetTradeDelays function is used in the following formulas in AFL on-line library: 

• AFL Example 

• AFL Example - Enhanced 

• CoinToss ver 1 

• Connors TPS 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• Envelope System 

• Evaluating Candle Patterns in a trading system 

• Last Five Trades Result Dashboard - AFL code 

• OBV with Linear Regression 

• Perceptron 

• PVT Trend Decider 

• Rapid Prototyping Method for System Development 

• Rebalancing Backtest avoiding leverage 

• Reverse MFI Crossover 

• RUTVOL timing signal with BB Scoring routine 

• Scale Out: Futures 

• Trend Following System 

• Triangular Moving Average new 

• Volatility System 

• ZLEMA ATR Long Only Trading System 


SetTradeDelays - allows to control trade delays applied by the backtester 
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More information: 

Updated on-line reference 


SetTradeDelays- allows to control trade delays applied by the backtester 
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Shell Execute Basic price pattern detection 

- execute a file ^ 


SYNTAX 

SheiiExecute( "fiiename", "arguments", "workingdir", showcmd = 1 ) 

RETURNS 

NUMBER 

FUNCTiON 

The function opens a file or runs executable. 

It is equivalent of Windows API SheiiExecute, with one difference, it always uses "open" 
verb. This allows running executables, scripts, opening document files using their associated 
editors, etc. 

If the function succeeds, it returns a value greater than 32. If the function fails, it returns an 
error value that indicates the cause of the failure. 

EXAMPLE 

For possible error codes, consult Microsoft documentation: 
http://msdn.microsoft.com/en-us/library/bb762153(VS.85).aspx 

ShellExecuteC'notepad.exe","",""); 

SEE ALSO 


References: 



The SheiiExecute function is used in the foliowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 


SheiiExecute - execute a file 
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sign 

- returns the sign of the number/array 


Math functions 

(AFL 2.50) 


SYNTAX sign( x) 

RETURNS ARRAY or NUMBER 

FUNCTION Sign function returns 1 if x vaiue is greater than zero, -1 if the x is iess than zero and 0 if x 
equais zero, x can be a number or array. 

EXAMPLE 

SEE ALSO 
References: 


The sign function is used in the following formulas in AFL on-line library: 

• Cybernertic Hilbert Sine Wave 

• Elder Triple Screen Trading System 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• John Ehler 

• Sine Wave Indicator 


More information: 


Updated on-line reference 


sign - returns the sign of the number/array 
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Indicators 


Signal 

- macd signal line 


SYNTAX Signal( fast =12, slow = 26, signal = 9 ) 
RETURNS ARRAY 

FUNCTION Calculates the Signal line of MACD Indicator. 

EXAMPLE slgnal( 14, 28, 10 ); 

SEE ALSO 
References: 


The Signal function Is used In the following formulas In AFL on-line library: 

• AFL Example - Enhanced 

• ALJEHANI 

• Bollinger band normalization 

• Button trading using AB auto trading Interface 

• Color MACD Histogram Changes 

• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• Compare Sectors against Tickers 

• Customised Avg. Profit %, Avg. Loss % etc 

• Detailed Equity Curve 

• DInapoll Guru Commentary 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• ekeko price chart 

• Elder Impulse Indicator 

• Elder Impulse Indicator V2 

• Elder Triple Screen Trading System 

• Fund Screener 

• hassan 

• ICHIMOKU SIGNAL TRADER 

• Indicator Explorer (ZIgZag) 

• Last Five Trades Result Dashboard - AFL code 

• MACD commentary 

• MACD Histogram - Change In Direction 

• MACD Indicator display 

• MACD optimize 

• Meu SIstema de Trading - versao 1.0 

• MFE and MAE and plot trades as Indicator 

• Rebalancing Backtest avoiding leverage 

• ROC of MACD Weekly 

• STO & MACD Buy Signals with Money-Management 

• swing chart 

• The Mean RSIt 

• The Mean RSIt (variations) 

• Trending or Trading ? 

• Trending Ribbon 


Signal - macd signal line 
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• TrendingRibbonArrowsADX 

• Varexiist 

• Vivek Jain 

More information: 

Updated on-line reference 


Signal- macd signal line 
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Math functions 


sin 

- sine function 


SYNTAX sin( NUMBER) 
sin( ARRAY) 

RETURNS NUMBER, 
ARRAY 


FUNCTION Returns the sine of NUMBER or ARRAY. This function assumes that the ARRAY vaiues are 
in radians. 


EXAMPLE You can piot a sine wave using the formuia "sin(cum(0.05))." Increasing the vaiue in this 
formuia (i.e., "0.05") wiii increase the frequency of the sine wave. 

SEE ALSO The atan() function ; the cos() function. 

References: 


The sin function is used in the foiiowing formuias in AFL on-iine iibrary: 

• AR_Prediction.afi 

• Coior Dispiay.afi 

• Cybernertic Hiibert Sine Wave 

• Cycie Highiighter 

• Cycle Highlighter (auto best-fit) 

• Cycle Period 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• John Ehler 

• Luna Phase 

• Moving Average "Crash" Test 

• Multiple sinus noised 

• Sine Wave Indicator 

• Trigonometric Fit - TrigFit with AR for cos / sin 

More information: 


Updated on-line reference 


sin - 


sine function 


1041 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


sinh 

- hyperbolic sine function 

SYNTAX sinh( NUMBER) 
sinh( ARRAY) 

RETURNS NUMBER, 

ARRAY 

FUNCTION Returns the hyperbolic sine of NUMBER or ARRAY. This function assumes that the ARRAY 
values are in radians. 

EXAMPLE 

SEE ALSO 
References: 

The sinh function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


Math functions 

(AFL 2.80) 


sinh - hyperbolic sine function 
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Sort 

- performs a quick sort of the array 


Miscellaneous functions 

(AFL 3.90) 


SYNTAX Sort( array, first = 0, last = -1, indexmode = False ) 

RETURNS ARRAY 

FUNCTION Sorts a numerical array in ascending order starting from first element ending at last element. 
If last is not specified or negative then AmiBroker will use BarCount -1. 


If indexmode = 0 then returned array holds actual sorted values, if indexmode = 1 the 
function returns array of indexes to the sorted values instead of values themselves. So if first 
returned value is 2923 it means that input array[ 2923 ] is the smallest element. 

EXAMPLE Filter = 1 ; 

AddColumn ( BarIndexO, "Bar Index", 1.0 ); 

AddColumn ( Close, "Close" ) ; 

// normal mode 

AddColumn ( Sort ( Close ), "Sorted Close" ); 

// index mode 

AddColumn ( Sort ( Close, 0, -1, True ), "Index of sorted item", 1.0 
) ; 


SEE ALSO 
References: 


The Sort function is used in the following formulas in AFL on-line library: 

• IBD relative strength database Viewer 

• JEEVAN'S SRI CHAKRA 

• sort function 


More information: 


Updated on-line reference 


Sort - performs a quick sort of the array 
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SparseCompress 
- compress sparse array 


Miscellaneous functions 

(AFL 4.0) 


SYNTAX SparseCompress( query_points, data ) 

RETURNS ARRAY 

FUNCTION The function gets values from 'data' array at points defined by non-zero values of 

'query_points' array and compresses them so they are squeezed at the end of resulting array 

EXAMPLE only, _when = ( Month 0 % 2 ) == 0; // even months only 

X = SparseCompress ( only_when. Close ) ; // compact sparse data 
y = MA ( X, 10 ); // regular calculation 

y = SparseExpand ( only_when, y ); // expand sparse data 

Plot ( C, "Price", colorDefault, styleBar ) ; 

Plot ( y, "Sparse MA from even months", colorRed ); 


function SparseCompressEquiv( sparse_array, data_array ) 

{ 

result = Null; 
j = BarCount - 1; 

for ( i = BarCount - 1; 1 >= 0; i— ) 

{ 

if ( sparse_array[ i ] ) result[ j— ] = data_array[ i ]; 

} 

return result; 

} 

function SparseExpandEquiv( sparse_array, data_array ) 

{ 

result = Null; 
j = BarCount - 1; 

for ( i = BarCount - 1; 1 >= 0; i— ) 

{ 

if ( sparse_array[ i ] ) result[ i ] = data_array[ j— ]; 

} 

return result; 

} 

SEE ALSO SparseExpandO function 


SparseCompress - compress sparse array 
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References: 

The SparseCompress function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-line reference 


SparseCompress- compress sparse array 
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SparseExpand 

- expand compressed array to sparse array 


Miscellaneous functions 

(AFL 4.0) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 


SparseExpand( query_points, data) 

ARRAY 

The function expands values from compressed 'data' array at points defined by non-zero 
values of 'query_points' 

only_when = ( Month () % 2 ) == 0; // even months only 
X = SparseCompress ( only_when. Close ); // compact sparse data 
y = MA ( X, 10 ); // regular calculation 

y = SparseExpand ( only_when, y ); // expand sparse data 

Plot ( C, "Price", colorDefault, styleBar ) ; 

Plot ( y, "Sparse MA from even months", colorRed ); 


function SparseCompressEquiv( sparse_array, data_array ) 

{ 

result = Null; 
j = BarCount - 1; 

for ( i = BarCount - 1; 1 >= 0; i— ) 

{ 

if ( sparse_array[ i ] ) result[ j— ] = data_array[ i ]; 

} 

return result; 

} 

function SparseExpandEquiv( sparse_array, data_array ) 

{ 

result = Null; 
j = BarCount - 1; 

for ( i = BarCount - 1; 1 >= 0; i— ) 

{ 

if ( sparse_array[ i ] ) result[ i ] = data_array[ j— ]; 

} 

return result; 

} 

SEE ALSO SparseCompressO function 


SparseExpand - expand compressed array to sparse array 


1046 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


References: 

The SparseExpand function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-line reference 


SparseExpand- expand compressed array to sparse array 


1047 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


sqrt 

- square root 


Math functions 


SYNTAX sqrt( NUMBER) 
sqrt( ARRAY) 

RETURNS NUMBER, 
ARRAY 


FUNCTION Calculates the square root of NUMBER or ARRAY. The square root of a negative number 
always returns a zero result. 

EXAMPLE The formula "sqrt( 16 )" returns 4 

SEE ALSO 
References: 


The sqrt function Is used In the following formulas In AFL on-line library: 

• 'R' Channel 

• Basket Trading System T101 

• Black Scholes Option Pricing 

• Commodity Selection Index (CSI) 

• crMathLIb 

• Cycle Period 

• Dave Landry PullBack Scan 

• Elder Triple Screen Trading System 

• Gann level plotter 

• Heatmap V1 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• Historical Volotlllty Scan - 6/100 

• Historical Volotlllty Scan - 50 Day 

• HLspread 

• Hull Moving Average 

• Hull with DEMA 

• ModIfled-DVI 

• Multiple Ribbon Demo 

• Option Calls, Puts and days till third friday. 

• Polarized Fractal Efficiency 

• Probability Calculator 

• Probability Density & Gaussian Distribution 

• Random Walk Index, base formula Included 

• RSI Trendlines and Wedges 

• Sony 

• Square of Nine Roadmap Charts 

• Stress with SuperSmoother 

• The FIbonacclan behavior 

• Tracking Error 

• Tracking Error 

• VWAP with standard deviation bands 

• Woodle's CCI Panel Basic 


sqrt - square root 
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• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

• z-dlstance from vwap 

More information: 

Updated on-line reference 


sqrt- square root 
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StaticVarCompareExchange 

- atomic interlocked static variable compare-exchange 
operation 


Miscellaneous functions 

(AFL 3.50) 


SYNTAX StaticVarCompareExchange( "varname", exchange, comperand ) 

RETURNS NUMBER 

FUNCTION Parameters: 

• "varname" - Specifies the name of the destination static variable. Static variable if 
exists must be scalar numeric type. If static variable is not initialized, the function 
assumes that it has value of zero. 

• exchange - specifies the exchange value. Scalar numeric. 

• comperand - specifies the value to compare to the destination static variable. Scalar 
numeric. 


Return Values: 

The return value is the initial value of the destination static variable. If variable did not exist, it 
returns zero. 


The StaticVarCompareExchange function performs an atomic comparison of the "varname" 
static variable value with the Comperand value. If the static variable value is equal to the 
Comperand value, the Exchange value is stored in the static variable. Otherwise, no 
operation is performed. 

The function StaticVarCompareExchange provides a simple mechanism for synchronizing 
access to static variables that are shared by multiple threads. The following examples show 
how to implement semaphore and critical section in AFL using StaticVarCompareExchange 
function. For more details see Tutorial: Efficient use of multithreading. 

EXAMPLE // EXAMPLE 1 : Simple semaphore (no waiting) 

if ( StaticVarCompareExchange ( "semaphore", 1, 0 ) == 0 ) // obtain 

semaphore 
{ 

// protected section here 

// Here you have exclusive access (no other threads that check 
for semaphore will enter simultaneously) 

///////////////////////// 

StaticVarSet ("semaphore" , 0 ); // reset semaphore 

} 

else 

{ 

_TRACE("Can not obtain semaphore"); 

} 


/////////////// 

// EXAMPLE 2 HOW TO IMPLEMENT CRITICAL SECTION IN AFL 
/////////////// 

function _TryEnterCS( secname ) 
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{ 

global _cursec; 

_cursec= 

// try obtaining semaphore for 1000 ms 
for ( i = 0; i < 1000; i++ ) 
if ( StaticVarCompareExchange ( secname, 1, 0 ) == 0 ) 
{ 

_cursec = secname; 

break; 

} 

else ThreadSleep ( 1 ); //sleep one millisecond 


return _cursec != 

} 


// call it ONLY when _TryEnterCS returned TRUE ! 
function _LeaveCS() 

{ 

global _cursec; 
if ( _cursec != "" ) 

{ 

StaticVarSet ( _cursec, 0 ) ; 

_cursec = 



function TimeConsumingWork() 

{ 

// WARNING: the Percentile is CPU hungry as it involves lots of 
sorting, the loop below may take > 1 second to complete 
for ( 1=0; i< 10; i++ ) Percentile ( C, 100, 10 ); 

} 

//_TRACE ("Without CS Begin " + GetChartIDO ); 

//TimeConsumingWork0; // some time consuming calculation 

//_TRACE ("Without CS End" + GetChartIDO ); 

// Example usage (critical section) 
if ( _TryEnterCS( "mysemaphore" ) ) 

{ 

// you are inside critical section now 
_TRACE ("Begin CS " + GetChartIDO ); 

TimeConsumingWork0; // some time consuming calculation 

_TRACE("End CS " + GetChartIDO ); 

_LeaveCS(); 

} 

else 

{ 

_TRACE ("Unable to enter CS"); 

} 
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SEE ALSO ThreadSleepO function 

References: 

The StaticVarCompareExchange function is used in the foilowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 
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StaticVarCount 

- get the total number of static variables in memory 


Miscellaneous functions 

(AFL 3.30) 


SYNTAX 
RETURNS 
FUNCTION 
EXAMPLE 
SEE ALSO 

References: 


StaticVarCountQ 

NUMBER 

the function returns total number of static variables in memory 

StaticVarGetO function , StaticVarGetText() function , StaticVarRemove() function , 
StaticVarSetO function , StaticVarSetText() function 


The StaticVarCount function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


StaticVarCount - get the total number of static variables in memory 
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StaticVarGenerateRanks 

- generate ranking of multiple symbols and store it to static 
variables 


Miscellaneous 

functions 

(AFL 3.70) 


SYNTAX StaticVarGenarateRanks( "outputprefix", "inputprefix", topranks, tiemode ) 

RETURNS NOTHING 

FUNCTION The function implements general-purpose multiple symbol bar-by-bar ranking. 

StaticVarGenarateRanks( "outputprefix", "inputprefix", topranks, tiemode ) 

"inputprefix" is a prefix that defines names of static variables that will be used as input for 
ranking. AmiBroker will search for all static variables that begin with that prefix and assume 
that remaining part of the variable name is a stock symbol. Say you want to rank stocks by 
ROC (rate of change). All you need to do is to store values into static variables. 

Let us say that we will use static variable names like "ValuesToSortAPPL", 
"ValuesToSortMSFT", and so on. 

To fill input static variables you can use this loop: 

for ( i = 0; ( sym = StrExtract ( symlist, i ) ) != i++ ) 

{ 

SetForeign (sym ); 

Value = ROC ( C, 10 ); 

RestorePriceArrays (); 

StaticVarSet ( "ValuesToSort" + sym. Value ); 

} 


Now you are ready to perform sorting/ranking. There are two modes, normal ranking mode 
and Top/Bottom Rank mode. 

Normal ranking mode is performed when toprank argument is set to zero. 
StaticVarGenerateRanks( "rank", "ValuesToSort", 0, 1224 ); 

In this case StaticVarGenerateRanks call would generate set of static variables starting with 
prefix defined by 2nd argument each variable holding the rank of particular symbol, so in this 
case 

RankValuesToSortMSFT will hold ranking of MSFT 
RankValuesToSortAAPL will hold ranking of AAPL 

Note that in AmiBroker rank count start from ONE. 

Third argument (topranks) is zero in normal ranking mode 

Fourth argument (tiemode) defines how ties are ranked. Supported modes are 1234 and 
1224. In 1224 mode ties are numbered with equal rank. 
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EXAMPLE 


Top/bottom ranking mode (that generates top/bottom ranking tabies that hoid indexes to top 
ranking values. When topranks > 0 top ranked values are used, when topranks < 0 then 
bottom ranked values are used. The values are stored in variables that have format of: 
OutputprefixInputprefixN where N is a number 1,2, 3 representing top/bottom ranks. Let us 
assume that OutputPrefix parameter is "Top" and Inputprefix parameter is ROC. In such case 
variable TopROCI would hold the index of top rated value. TopROC2 would hold second top 
rated value, and so on. 

StaticVarGenerateRanks function uses rank numbering that starts from ONE. 

In top ranking mode StaticVarGenerateRanks will also prepare static variable that contains 
comma separated list of variable names that can be used to find out which index refers to 
which symbol. So if TopROCI holds 1 you would lookup first substring in TopROCSymbols 
variable to find out what variable (symbol) ranked at the top. Additionally 
StaticVarGetRankedSymbols gives easy-to-use method to retrieve comma separated list of 
ranked symbols for particular datetime. 

///////////////////////////////// 

// Example 1. code for normal ranking mode 

// (everything done Is done In one pass, can be used In Indicator): 
///////////////////////////////// 

symlist = "C,CAT,DD,GE,IBM,INTO,MSFT" ; 

// delete static variables - DO NOT forget the asterisk (wildcard) 
at the end 

StaticVarRemove ( "ValuesToSort*" ); 

// fill input static arrays 

for (1 = 0; ( sym = StrExtract ( symlist, 1 ) ) != i + + ) 

{ 

SetForeign ( sym ); 

Value = ROC ( C, 10 ) ; 

RestorePriceArrays (); 

StaticVarSet ( "ValuesToSort" + sym. Value ); 

} 


// perform ranking 

StaticVarGenerateRanks ( "rank", "ValuesToSort", 0, 1224 ); // normal 
rank mode 

// read ranking 

for (1=0; ( sym = StrExtract ( symlist, 1 ) ) != i++ ) 

{ 

Plot ( StaticVarGet ( "RankValuesToSort" + sym ), sym, 

colorCustomlO + 1 ) ; 

} 

///////////////////////////////// 

// Example 2. Code for top ranking mode 
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// (everything done is done in one pass, can be used in indicator): 

///////////////////////////////// 


symlist = "C,CAT,DD,GE,IBM,INTO,MSFT" ; 

// delete static variables - DO NOT forget the asterisk (wildcard) 
at the end 

StaticVarRemove ( "ValuesToSort*" ); 

// fill input static arrays 

for ( i = 0; ( sym = StrExtract ( symlist, i ) ) != i++ ) 

{ 

SetForeign ( sym ); 

Value = ROC ( C, 10 ) ; 

RestorePriceArrays (); 

StaticVarSet ( "ValuesToSort" + sym. Value ); 

} 

// perform ranking 

StaticVarGenerateRanks ( "rank", "ValuesToSort", 0, 1224 ); // normal 
rank mode 

StaticVarGenerateRanks ( "top", "ValuesToSort", 3, 1224 ); // top-N 
mode 

StaticVarGenerateRanks ( "bot", "ValuesToSort", -3, 1224 ); // 
bottom-N mode 

// read ranking 

for ( i = 0; ( sym = StrExtract ( symlist, i ) ) != i + + ) 

{ 

Plot ( StaticVarGet ( "RankValuesToSort" + sym ), sym, 

colorCustomlO + i ); 

} 


sdt = SelectedValue ( DateTimeO ); 

Title = "{{NAME}} -{{DATE}} - {{VALUES}} TOP: " + 
StaticVarGetRankedSymbols ( "top", "ValuesToSort", sdt ) + 

" BOT: " + StaticVarGetRankedSymbols} "bot", "ValuesToSort", 

sdt ) ; 

SEE ALSO StaticVarGetRankedSymbolsO function 

References: 

The StaticVarGenerateRanks function is used in the foiiowing formuias in AFL on-iine iibrary: 
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More information: 

Updated on-line reference 


StaticVarGene rate Ranks- generate ranking of multiple symbols and store it to staticvariables 
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StaticVarGet 

- gets the value of static variable 

SYNTAX StaticVarGet( "varname', align = True') 

RETURNS NUMBER or STRING 

FUNCTION Gets the value of static variable. 

Static variable - the variable has static duration (it is allocated when the program begins and 
deallocated when the program ends) and initializes it to Null unless another value is 
specified. Static variables allow to share values between various formulas. ARRAY static 
variables are now supported (version 5.30 and above). 

Please note that static array variable will consume 8 * (number_of_bars) bytes of memory 
and it won't be released until program is closed or variable is removed using 
StaticVarRemove(). 

Static arrays can be even 100 faster than AddToComposite/Foreign, however these two are 
not strictly equivalent. 

There are following limitations / differences of static arrays as compared to 
Foreign/AddToComposite: 

a) static array variables store only as many bars as there are currently in use by given chart 
(so they do not affect QuickAFL in any way). This is different that AddToComposite that 
forces usage and store of all bars. 

b) static array variables work best if you read them using the same interval as they were 
written to. I.e when you create static array variables using 5-minute chart, for best results 
read them in some other 5-minute chart. Reading in different intervals is possible, but subject 
to limitations of timestamping (see below) 

c) when you read static variable in a different interval that it was originally stored, static 
variables perform padding/synchronization and time compression/decompression 
automatically in a similar way as foreign, however Foreign compresses data always from 
base-time interval, while static variables operate on previously stored interval, hence result 
may differ. For example, if previously stored data was in daily interval, and you read such 
static variable in intraday chart, you will see essentially flat lines for each day, representing 
static data from daily interval. 

d) static array variables do not work well for non-time based intervals (tick/n-volume/n-tick) 
because timestamps in those intervals may not be unique (i.e. several bars may have same 
time stamp), so time synchronization is not reliable. 

e) static array variables are little slower than normal AFL variables, so for best performance, 
use read-once, write-once paradigm, using temporary normal variable for any processing 
during formula execution, like this: The new align parameter (default = true) decides 
whenever AmiBroker performs timestamp synchronization/alignment or not. 

The default value is True and it means that values stored in static variables are retrieved and 
aligned to currently selected symbol data/timestamp on each bar basis so data for 
corresponding date/time stamps match. This is recommended setting and this is the way it 
worked in previous versions. 


Miscellaneous functions 

(AFL 2.60) 


StaticVarGet - gets the value of static variable 
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When align is switched to False - it means that AmiBroker does not perform any checks nor 
any alignment and will fill the array with consecutive values stored in static array regardless 
of their timestamps. If there are less bars in the static array than in the current arrays, the last 
value of static array will be propagated till BarCount -1. 

It is advised NOT to use align=False, unless you know exactly what you are doing and you 
are aware that date/time stamps have no meaning in particular variable or in case when 
date/time stamps are are aligned using your own method. 

Note that speed difference between align 'on' and 'off is usually negligible because 
alignment algorithm is very fast and has similar complexity as plain memory copy. 

EXAMPLE // start of the formula: 

temp = StaticVarGet ( "mystaticarray" ); 

// now perform all necessary calculations using temp variable 
temp = Nz (temp) + C/2; 

// at the end of the formula store to static 
StaticVarSet ( "mystaticarray" , temp ); 

SEE ALSO StaticVarSetO function , StaticVarSetText() function , StaticVarGetText() function 

References: 

The StaticVarGet function is used in the following formulas in AFL on-line library: 

• AFL Timing functions 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Button trading using AB auto trading interface 

• Continuous Contract Rollover 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Heatmap VI 

• Herman 

• interactively test discretionary trading 

• Manual Bracket Order Trader 

• Non-repaitning Zigzag line 

• Now Send Push Notifications From Amibroker 

• Rebalancing Backtest avoiding leverage 

• suresh 

• Visi-Trade 

• Woodie's CCI Panel Full Stats 


StaticVarGet- gets the value of static variable 
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More information: 

Updated on-line reference 


StaticVarGet- gets the value of static variable 
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StaticVarGetRankedSymbols 

- retrieve a list of ranked symbols from static variables 


Miscellaneous functions 

(AFL 3.70) 


SYNTAX StaticVarGetRankedSymbols( "outputprefix", "inputprefix", datetime ) 

RETURNS STRING 

FUNCTION Retrieves the comma-separated list of symbols from static variables generated using 
StaticVarGenerateRanks. For more information see StaticVarGenerateRanks 
documentation. 

EXAMPLE symlist = "C,CAT,DD,GE,IBM,INTO, MSFT" ; 


// delete static variables 
StaticVarRemove ( "ValuesToSort*" ) ; 


// fill input static arrays 

for ( i = 0; ( sym = StrExtract ( symlist, i ) ) != i++ ) 

{ 

SetForeign (sym ); 

Value = ROC ( C, 10 ) ; 

RestorePriceArrays (); 

StaticVarSet ( "ValuesToSort" + sym. Value ); 

} 


// perform ranking 

StaticVarGenerateRanks ( "rank", "ValuesToSort", 0, 1224 ); // normal 
rank mode 

StaticVarGenerateRanks ( "top", "ValuesToSort", 3, 1224 ); // top-N 
mode 

StaticVarGenerateRanks! "bot", "ValuesToSort", -3, 1224 ); // 
bottom-N mode 
// read ranking 

for ( i = 0; ( sym = StrExtract! symlist, i ) ) != i + + ) 

{ 

Plot! StaticVarGet ! "RankValuesToSort" + sym ), sym, colorCustomlO + 

i ) ; 

} 


sdt = SelectedValue ! DateTime!) ); 

Title = "{{NAME}} -{{DATE}} - {{VALUES}} TOP: " + 
StaticVarGetRankedSymbols! "top", "ValuesToSort", sdt ) + 

" BOT: " + StaticVarGetRankedSymbols! "bot", "ValuesToSort", sdt ) ; 

SEE ALSO StaticVarGenerateRanksO function 

References: 

The StaticVarGetRankedSymbols function is used in the following formulas in AFL on-line library: 


StaticVarGetRankedSymbols - retrieve a list of ranked symbols from static variables 
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More information: 

Updated on-line reference 


StaticVarGetRankedSymbols- retrieve a list of ranked symbols from static variables 
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StaticVarGetText 

- gets the value of static variable as string 


Miscellaneous functions 

(AFL 2.60) 


SYNTAX StaticVarGetText( "varname") 

RETURNS STRING 

FUNCTION Gets the value of static variable as string. 

The only difference between StaticVarGet is that this function always returns string, so if 
given static variable does not exist it returns empty string "" instead of Null. Numbers are also 
converted to string. 


Static variable - the variable has static duration (it is allocated when the program begins and 
deallocated when the program ends) and initializes it to Null unless another value is 
specified. Static variables allow to share values between various formulas. Array static 
variables are now supported (version 5.30 and higher) 

EXAMPLE myvar = StaticVarGetText ( "MyVariable") ; 


if ( myvar == "" ) 

{ 

printfC'Not Set"); 


else 

{ 

printf ( "Variable Set: " + myvar); 

} 


SEE ALSO StaticVarGetO function , StaticVarSet() function , StaticVarSetText() function 

References: 


The StaticVarGetText function is used in the following formulas in AFL on-line library: 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Button trading using AB auto trading interface 

• Calculate composites for tickers in list files 

• Continuous Contract Rollover 

• DateNumDateStr 

• Heatmap VI 

• Manual Bracket Order Trader 

• Ranking and sorting stocks 

• suresh 

• TWS auto-export Executions-file parser 

• Visi-Trade 

• Woodie's CCI Panel Full Stats 


StaticVarGetText - gets the value of static variable as string 
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More information: 

Updated on-line reference 


StaticVarGetText- gets the value of static variable as string 
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StaticVarInfo 

- get the information about static variabie(s) 


Miscellaneous functions 

(AFL 3.60) 


SYNTAX StaticVarlnfo( "varname", "field" ) 

RETURNS STRING or NUMBER 

FUNCTION The function provides information about static variabies. 
Arguments: 


• "varname" - is a variabie name. It can be also a wildcard template such as 
"myvariable*" and then it means that AmiBroker will search for all variables beginning 
with " myvariable". * character matches any string, ? matches any single character 

• "field" - defines the information to retrieve. Supported "field" values are: 

♦ "list" - returns the list of static variables 

♦ "memory" - returns memory usage in bytes (not including memory used for 
variable name itself) 

♦ "totalmemory" - returns memory usage in bytes (including memory used for 
variable name) 

EXAMPLE StaticVarSet ( "my_arrayl " , Close ); 

StaticVarSet ( "my_array2" , Close ); 

StaticVarSet ( "my_scalar" , 12 ); 

StaticVarSetText ( "my_text" , "Textl23456" ); 


"All variables in memory: " + StaticVarInfo ( "list" ); 

" Total static var memory: " + StaticVarInfo ( "totalmemory"); 

" Only my_ variables: " + StaticVarInfo ( "my_*", "list" ); 

" Memory 2 arrays (bytes): " + StaticVarInfo ( "my_array*", "memory" 


" Memory scalar (bytes): " + StaticVarInfo ( "my_scalar", "memory" ); 

" Memory text (bytes): " + StaticVarInfo ( "my_text", "memory" ); 

SEE ALSO StaticVarCompareExchangeO function , StaticVarCount() function , StaticVarGetQ function , 
StaticVarGetTextO function , StaticVarRemove() function , StaticVarSet() function , 
StaticVarSetTextO function 

References: 


The StaticVarInfo function is used in the following formulas in AFL on-line library: 

More Information: 


Updated on-line reference 


StaticVarInfo - get the information about static variable(s) 
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StaticVarRemove 
- remove static variable 


Miscellaneous functions 

(AFL 2.80) 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


StaticVarRemove( "variablename") 

NOTHING 

This function removes static variabie and reieases associated memory. 

With AmiBroker version 5.30, StaticVarRemove() supports wiidcards in the variabie name. 

"varname" parameter can be either exact variabie name or wiidcard match string. 

The matches any number of characters, inciuding zero characters. The '?' matches exactiy 
one character. 

Example 1: 

StaticVarRemove("MyVariables*"); 

// this will remove all static variables beginning with MyVariables prefix. 

StaticVarSet ( "DifferentName" , 1 ); 

printf ( "Total static variables = %g\n\n", StaticVarCount () ); 

for ( i = 1; i <= 5; i++ ) 
for ( j = 1; j <= 5; j++ ) 


VarName = "Test_X=" + i + "_Y=" + j; 

printf ( "Setting variable " + VarName + "\n" ); 

StaticVarSet ( Varname, 1 ) ; 

} 

printf ( "Total static variables = %g\n\n", StaticVarCount () ); 

printf ( "Now wildcard remove *X=l*\n" ); 

StaticVarRemove ( "*x=l*" ); 

printf ( "Total static variables = %g\n\n", StaticVarCount () ); 

printf ( "Now wildcard remove Test*\n" ); 

StaticVarRemove ( "Test*" ); 

printf ( "Total static variables = %g\n\n", StaticVarCount () ); 

printf ( "Removing 'differenname' variableVn" ); 

StaticVarRemove ( "DifferentName" ); 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


StaticVarRemove - remove static variable 


1066 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


printf ( "Total static variables = %g\n\n", StaticVarCount () ); 

SEE ALSO StaticVarGetO function , StaticVarGetText() function , StaticVarSet() function , 
StaticVarSetTextO function 

References: 

The StaticVarRemove function is used in the foliowing formulas in AFL on-line library: 

• GFX ToolTip 

• Visi-Trade 

More information: 

Updated on-line reference 


StaticVarRemove- remove static variable 
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StaticVarSet 

- sets the value of static variable 


Miscellaneous functions 

(AFL 2.60) 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 

StaticVarSet 


StaticVarSet( "varname", value, persistent = False) 

NUMBER 

Sets the value of static variable. Returns 1 on success 0 on failure. 

Static variable - the variable has static duration (it is allocated when the program begins and 
deallocated when the program ends) and initializes it to Null unless another value is 
specified. Static variables allow to share values between various formulas. ARRAY static 
variables are now supported (version 5.30 and above). 

Please note that static array variable will consume 8 * (number_of_bars) bytes of memory 
and it won't be released until program is closed or variable is removed using 
StaticVarRemoveQ. 

Starting from version 5.80 there is a new parameter 'persist'. If it is set to True then static 
variable will be stored in PersistVars.bin file when AmiBroker is closing and reloaded 
automatically on next startup, preserving the values of static variables between application 
runs). In addition to saving them automatically on exit, persistent static variables can be 
auto-saved at user-specified intervals using SetOption("StaticVarAutoSave", interval); 

Static arrays can be even 100 faster than AddToComposite/Foreign, however these two are 
not strictly equivalent. 

There are following limitations / differences of static arrays as compared to 
Foreign/AddToComposite: 

a) static array variables store only as many bars as there are currently in use by given chart 
(so they do not affect QuickAFL in any way). This is different that AddToComposite that 
forces usage and store of all bars. 

b) static array variables work best if you read them using the same interval as they were 
written to. I.e when you create static array variables using 5-minute chart, for best results 
read them in some other 5-minute chart. Reading in different intervals is possible, but subject 
to limitations of timestamping (see below) 

c) when you read static variable in a different interval that it was originally stored, static 
variables perform padding/synchronization and time compression/decompression 
automatically in a similar way as foreign, however Foreign compresses data always from 
base-time interval, while static variables operate on previously stored interval, hence result 
may differ. For example, if previously stored data was in daily interval, and you read such 
static variable in intraday chart, you will see essentially flat lines for each day, representing 
static data from daily interval. 

d) static array variables do not work well for non-time based intervals (tick/n-volume/n-tick) 
because timestamps in those intervals may not be unique (i.e. several bars may have same 
time stamp), so time synchronization is not reliable. 

e) static array variables are little slower than normal AFL variables, so for best performance, 
use read-once, write-once paradigm, using temporary normal variable for any processing 
during formula execution, like this: 

// start of the formula: 
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FUNCTION 


EXAMPLE 

StaticVarSet 
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temp = StaticVarGet ( "mystaticarray" ); 

// now perform all necessary calculations using temp variable 
temp = Nz (temp) + C/2; 


// at the end of the formula store to static 
StaticVarSet ( "mystaticarray" , temp ); 

SEE ALSO StaticVarSetTextO function , StaticVarGet() function 

References: 

The StaticVarSet function is used in the foiiowing formuias in AFL on-iine iibrary: 

• 2 Timeframes Candiestick Bar Chart 

• AFL Timing functions 

• AFL_Giossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Fiow 

• AutoTrade using an Expioration 

• AutoTrader Basic Fiow - updated Aprii 15, 2009 

• AutoTrader Basic Fiow - updated Nov 18, 2008 

• Button trading using AB auto trading interface 

• Continuous Contract Roiiover 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Fleatmap VI 

• Flerman 

• interactiveiy test discretionary trading 

• Manuai Bracket Order Trader 

• Non-repaitning Zigzag iine 

• Now Send Push Notifications From Amibroker 

• Ranking and sorting stocks 

• Rebaiancing Backtest avoiding ieverage 

• suresh 

• Visi-Trade 

• Woodie's CCI Panei Fuii Stats 
More information: 

Updated on-line reference 


StaticVarSet- sets the value of static variable 
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StaticVarSetText 

- Sets the value of static string variable. 


Miscellaneous functions 

(AFL 2.60) 


SYNTAX StaticVarSetText( "varname", "value", persist = False ) 

RETURNS 

FUNCTION Sets the value of static string variable. Returns 1 on success 0 on failure. 

Static variable - the variable has static duration (it is allocated when the program begins and 
deallocated when the program ends) and initializes it to Null unless another value is 
specified. Static variables allow to share values between various formulas. 


Starting from version 5.80 there is a new parameter 'persist'. If it is set to True then static 
variable will be stored in PersistVars.bin file when AmiBroker is closing and reloaded 
automatically on next startup, preserving the values of static variables between application 
runs). In addition to saving them automatically on exit, persistent static variables can be 
auto-saved at user-specified intervals using SetOption("StaticVarAutoSave", interval); 


EXAMPLE 

SEE ALSO StaticVarSetO function , StaticVarGet() function 

References: 


The StaticVarSetText function is used in the following formulas in AFL on-line library: 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Button trading using AB auto trading interface 

• Calculate composites for tickers in list files 

• Continuous Contract Rollover 

• DateNumDateStr 

• Heatmap VI 

• Manual Bracket Order Trader 

• Ranking and sorting stocks 

• suresh 

• TWS auto-export Executions-file parser 

• Visi-Trade 

• Woodie's CCI Panel Full Stats 


More information: 


Updated on-line reference 


StaticVarSetText - Sets the value of static string variable. 
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Status 

- get run-time AFL status information 

SYNTAX status( "statuscode") 

RETURNS ARRAY 

FUNCTION Returns run-time status of the analysis engine. Supported status codes: 

• "stocknum" - gives you the ordinal number of currently analysed symbol 

• "action" - gives information in what context given formula is run: 1 - actionindicator 
(INDICATOR), 2 - actionCommentary (COMMENTARY), 3 - actionScan (SCAN), 4 - 
actionExplore (EXPLORATION), 5 - action Backtest (BACKTEST / OPTIMIZE), 6 - 
action Portfolio (portfolio backtest). The value of action Backtest (5) (backtest) is used 
also in some other contexts (like code check and profile). Therefore you can use 
ActionEx to get more detailed/precise information 

• "ActionEx" (new in 5.20) - more detailed information about action that triggered AFL 
execution. Note that 5 first codes are the same as Status("action") but scope is 
limited to 'core' meaning (see notes below). 

Possible values 

1. actionindicator - when indicator is being repainted (NOTE: 5.32 - indicator 
can also give actionExInterpret when updating both chart and interpretation) 

2. actionCommentary (NOTE: commentary only, not interpretaion nor tooltip) 

3. actionScan - when AA Scan is performed 

4. actionExplore - when AA exploration is performed 

5. actionBacktest (NOTE backtest only, no optimization) 

6. action Portfolio (2nd phase of portfolio backtest (custom backtest) 

7. reserved for future use 

8. reserved for future use 

9. reserved for future use 

10. - actionExAAShowArrows - when AA "Show arrows" command is used 

11. actionExAAParameters - when AA "Parameters" dialog is displayed/updated 

12. actionExEditVerifyFormula - when AFL editor verifies syntax 

13. actionExOptimizeSetup - when Optimize() parameters are read (to setup 
optimization engine) 

14. actionExOptimizeBacktest - when Backtest is performed as a part of 
optimization process 

15. actionExOptimizePortfolio - when portfolio-backtest phase (CUSTOM 
backtester) is performed as a part of optimization process 

16. actionExTooltip - when tooltip for given chart is being displayed/updated 

17. actionExInterpret - when the Interpretation window is being updated (can 
also mean indicator -i- interpretation in 5.32 above, see note below) 

18. (not used, reserved for future) actionExAAInit - when AA needs to initialize 
QuickAFL bars required information and/or formula contains functions 
changing general AA options 


Miscellaneous functions 

(AFL 1.65) 


NOTE: for backward compatiblity with all formulas you have written already, the 
codes for Status("action") did NOT change. 

NOTE ABOUT 5.32.x CHANGE: Since introduction of multi-threading, there is only 


Status - get run-time AFL status information 
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ONE pass/execution that updates both indicator and interpretation when current 
chart pane has focus. Status("action") wiii aiways return actionindicator and 
Status("actionex") wiii either return actionExInterpret (when chart pane has focus and 
intepretation window is visibie) or actionindicator otherwise (when pane does not 
have focus or interpretation is NOT visibie). Be carefui NOT to disabie Piot() 
depending on Status("actionex") code. If you really think you need to execute Plot() 
conditionally you should only check for Status("action")==actionlndicator. 

• "rangefromdate", "rangetodate" - return current auto-analysis From-To range as 
DateNums 

• "rangefromtime", "rangetotime" - return current auto-analysis From-To range as 
DateNums 

• "barinrange" - returns 1 when current bar is within current auto-analysis From-To 
range 

• "barvisible" - (custom indicators only) returns 1 when current bar is visible in current 
view 

• "firstbarinrange" and "lastbarinrange". They return 1 (or True) on the first/last bar of 
analysis range. 

• "buydelay", "selldelay", "shortdelay", "coverdelay" - return delays set in the Settings 
window 

• "firstbarintest" and "lastbarintest" - similar to "firstbarinrange" and "lastbarinrange" 
but they return the settings of last BACKTEST/OPTIMIZATION and intermediate 
scans/explorations do not affect them 

• "firstvisiblebar", "lastvisiblebar", "firstvisiblebarindex", "lastvisiblebarindex" - return 
bar number or bar index of first/last visible bar. Available in indicator mode only. 
Visible bar may potentially include "blank" future bars (past the last bar in the array) 
as defined in preferences 

• "redrawaction" - returns 0 (zero) for regular refreshes, and 1 for refreshes triggered 
via RequestTimedRefresh(). 

• "pxwidth" - returns pixel width of chart window pane (indicators only, low-level gfx) 
(AmiBroker 4.94 or higher) 

• "pxheight" - returns pixel height of chart window pane (indicators only, low-level gfx) 
(AmiBroker 4.94 or higher) 

• "axisminy" - retrieves the minimum (bottom) value of Y axis (indicators only, low-level 

gfx) 

• "axismaxy" - retrieves the maximum (top) value of Y axis (indicators only, low-level 

gfx) 

• "pxchartleft" - returns x-coordinate of top-left corner of chart area 

• "pxcharttop" - returns y-coordinate of top-left corner of chart area 

• "pxchartright" - returns x-coordinate of bottom-right corner of chart area 

• "pxchartbottom" - returns y-coordinate of bottom-right corner of chart area 

• "pxchartwidth" - returns width chart area (right-left) 

• "pxchartheight" - returns width chart area (bottom-top) 

• "quickafifirstdatabar", "quickafllastdatabar" - This feature is for internal use only. 
These are bar indexes of actual underlying compressed quotation array that make up 
AFL's array[ 0 ] and array[ BarCount -1] 

• "timeshift" - returns database timeshift expressed in seconds (v5.60) 

• "lastbarend" - returns DateTime of the end of last bar. For example 5 -minute bar at 
9:00 will have end time of 9:04:59 (works for time-based bars only) (v5.60) 

• "lastbartimeleft" - returns number of seconds to the completion of current last bar. 
Works for time-based bars only. Note that for proper operation this requires database 
timeshift to be set properly (so dates displayed on chart match your local computer 


Status - get run-time AFL status information 
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EXAMPLE 


time zone). (v5.60) 

• "lastbartimeleftrt" - it works like "lastbartimeleft" but uses the most recent RT stream 
update time instead of Now(). Also added Status("lastrtupdate") - time of last RT 
stream update Depends on RT plugin to deliver correct DateUpdate / TimeUpdate 
data. If plugin or date source sends incorrect datetimestamps or does not send 
DateUpdate/TimeUpdate correctly this function will not operate properly. Note that 
most data sources send weird (not current) datetime stamps on weekends. Also 
IQFeed plugin sends DateUpdate/TimeUpdate only inside regular trading hours. 
(V5.60) 

• "lastrtupdate" - returns date time of last update sent by RT plugin (see remarks 
above) (v5.60) 

• "ThreadID" - returns current thread ID under which formula is executed. 

Example 1: 

if ( Status ( "redrawaction" ) ==1 ) 

{ 

_TRACE ("nTIMED REFRESH" +Now ()); 

} 

RequestTimedRefresh (1) ; 

Example 2 (low-level graphic overlay + pixel co-ordinate conversion): 

_SECTION_BEGIN( "GfxOverlaySampleNew" ) ; 

function GetVisibleBarCount() 

{ 

Ivb = Status ( "lastvisiblebar" ); 

fvb = Status ("firstvisiblebar") ; 

return Min ( Lvb - fvb, BarCount - fvb ) ; 

} 


function GfxConvertBarToPixelX( bar ) 

{ 

lvb = Status ( "lastvisiblebar" ); 
fvb = Status ("firstvisiblebar") ; 
pxchartleft = Status ( "pxchartleft") ; 
pxchartwidth = Status ( "pxchartwidth" ); 

return pxchartleft + bar * pxchartwidth / ( Lvb - fvb + 1 ) ; 

} 


function GfxConvertValueToPixelY( Value ) 

{ 

local Miny, Maxy, pxchartbottom, pxchartheight; 

Miny = Status ( "axisminy" ); 

Maxy = Status ( "axismaxy" ); 

pxchartbottom = Status ( "pxchartbottom" ); 


Status - get run-time AFL status information 
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pxchartheight = Status ( "pxchartheight") ; 

return pxchartbottom - floor ( 0.5 + ( Value - Mlny ) * 
pxchartheight/ ( Maxy - Mlny ) ) ; 

} 


Plot (C, "Price", colorBlack, styleHistogram ); 

GfxSetOverlayMode (0) ; 

GfxSelectSolidBrush ( colorRed ) ; 

GfxSelectPen ( colorRed ); 

AllVisibleBars = GetVisibleBarCount(); 
fvb = Status ("firstvisiblebar") ; 

for ( 1=0; 1 < AllVisibleBars ; i++ ) 

{ 

X = GfxConvertBarToPixelX ( 1 ); 
y = GfxConvertValueToPixelY( C[ 1 + fvb ] ); 

GfxRectangle ( x-1, y-1, x + 2, y+1 ); 

} 


//SetChartBkGradientFill( ColorRGB(200,200,200), ColorRGB( 
255,255,255) ); 

_SECTION_END() ; 

SEE ALSO RequestTimedRefreshO function 

References: 

The Status function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Pivots And Prices And Swing Voiume 

• 2 Timeframes Candiestick Bar Chart 

• 3TF Candiestick Bar Chart 

• AFL Exampie - Enhanced 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• Auto-Optimization Framework 

• Automatic Trendlines using multiple timeframes 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• babaloo chapora 

• Basket Trading System T101 

• Bid Vs Ask Dashboard 

• Button trading using AB auto trading interface 
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• Calculate composites for tickers In list files 

• Candle Identification 

• Candle Stick Analysis 

• Candle Stick Demo 

• CCI(20) Divergence Indicator 

• Channel/S&R and trendlines 

• Color Display.afl 

• Congestions detection 

• Customised Avg. Profit %, Avg. Loss % etc 

• Detailed Equity Curve 

• DPO with shading 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• End Of Year Trading 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Fibonacci Internal and External Retracements 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Heatmap V1 

• Herman 

• ICHIMOKU SIGNAL TRADER 

• Interactively test discretionary trading 

• Intraday FIbonacll Trend Break System 

• Inverted Plotted Volume Overlay Indicator 

• MACD Indicator display 

• Manual Bracket Order Trader 

• Market Breadth Chart-In-Chart 

• Market Profile 

• MFE and MAE and plot trades as Indicator 

• Multiple Ribbon Demo 

• Murrey Math Price Lines 

• Ord Volume 

• Perceptron 

• Pivot Finder 

• Pivots And Prices 

• prakash 

• Probability Density & Gaussian Distribution 

• Ranking and sorting stocks 

• Rebalancing Backtest avoiding leverage 

• Relative Strength Multichart of up to 10 tickers 

• Rene RIjnaars 

• RUTVOL timing signal with BB Scoring routine 

• shallu lunia 

• Simple Candle Exploration 

• Trend Exploration: Count Number of New Highs 

• Trend Exploration: Slope Moving Average 

• Trix Bars number 

• TWS auto-export Executlons-flle parser 

• TWS trade plotter 

• Ultimate plus 

• Using From and To dates from Auto Analysis In Code 
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• Visible Min and Max Value Demo 

• Volume Charts 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Full Stats 

• ZigZag Fli Lo Barcount 

More information: 

Updated on-line reference 
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StdErr Statistical functions 

- Standard error ^ 


SYNTAX 

StdErr( ARRAY, periods ) 

RETURNS 

ARRAY 

FUNCTION 

Caicuiates standard error function (standard error of iinear regression estimate) of the 

ARRAY over periods bars The function accepts periods parameter that can be constant as 
weii as time-variant (array). 

EXAMPLE 

StdErr( ciose, 10 ); 

SEE ALSO 


References: 



The StdErr function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Automatic Linear Trend Channei 

• Automatic Linear Trend Channei 2 

• Automatic trend channei 

• Standard Error Bands (Native AFL) 

More information: 

Updated on-iine reference 


StdErr - standard error 
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StDev 

- standard deviation 


Statistical functions 

(AFL 1.4) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
Comments: 


StDev( ARRAY, periods ) 

ARRAY 

Calculates moving standard deviation of the ARRAY over periods bars 
stdev( close, 10); 


Tomasz 

Note that If you are trying to compare results of StDev function to Excel output you should 

Janeczko 

use STDEVP function In Excel (not StDev). 

2006-04-04 


16:26:27 



References: 


The StDev function Is used In the following formulas In AFL on-line library: 

• % B of Bollinger Bands With Adaptive Zones 

• Adaptive Price Channel 

• AR_Predlctlon.afl 

• BB squeeze 

• Bollinger Band Width 

• Bollinger oscillator 

• CCT Bollinger Band Oscillator 

• Congestions detection 

• correlerror 

• CVR-severe filter 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Dave Landry PullBack Scan 

• DMI Spread Index 

• Dynamic Momentum Index 

• Dynamic Momentum Index 

• Dynamtic Momentum Index 

• Effective Swing Indicator 

• Elder Triple Screen Trading System 

• Elder's SafeZone Stop 

• Follow the Leader 

• Historical Volotlllty Scan - 6/100 

• Historical Volotlllty Scan - 50 Day 

• HLspread 

• Inter-market Yield Linear Regression Divergence 

• Kelly criterion 

• Kiss and Touch with the Modified True Range 

• Linear Regression Line w/ Std Deviation Channels 


StDev - standard deviation 
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• Moving Trend Bands (MTB) 

• Multicycle 1.0 

• nikhil 

• NR4 Historical Volatility System 

• NRx Exploration 

• Probability Calculator 

• Probability Density & Gaussian Distribution 

• Trend Exploration: Count Number of New Highs 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Volatility 

• Volume Occilator 

• Z-Score Indicator 

More information: 

Updated on-line reference 


StDev- standard deviation 
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StochD Indicators 

- stochastic slow %D 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


StochD( periods =14, Ksmooth=3, Dsmooth=3 ) 

ARRAY 

Calculates the %D line of Stochastic Oscillator (with Internal slowing KSmooth, DSmooth). 
The formula "stochd( 5 )" returns the value of a 5-perlod %D double smoothed by 3 periods 
STOCHKO function 


The StochD function Is used In the following formulas In AFL on-line library: 

• Adaptave Zones 0/B & 0/S Oscillator 

• Auto-Optimizatlon Framework 

• Bollinger Band Gap 

• COMBO 

• DInapoll Guru Commentary 

• DInapoll Perferred Stochastic 

• Divergences 

• Fund Screener 

• hassan 

• ICHIMOKU SIGNAL TRADER 

• Index and ETF trading 

• Stochastic Divergence, negative 

• Stochastic Divergence, positive 

• Stochastic Divergences, PDI, NDI 

• Stochastic optimize 

• Stochastic Oscillator 

• Stochastic OSI & OBI 

• Stochastics Trendlines 

• swing chart 

• TrendIngRIbbonArrowsADX 

More information: 


Updated on-line reference 


StochD - stochastic slow %D 
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StochK Indicators 

- stochastic slow %K 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


StochK( periods =14, ksmooth=3 ) 

ARRAY 

Calculates the %K line of Stochastic Oscillator (with Internal slowing KSmooth). 

The formula "stochk( 5 )" returns the value of a 5-perlod %K slowed down 3 periods. 
STOCHDO function 


The StochK function Is used In the following formulas In AFL on-line library: 

• Adaptave Zones 0/B & 0/S Oscillator 

• Against all odds 

• Auto-Optimizatlon Framework 

• CandleStochastIcs 

• COMBO 

• DInapoll Guru Commentary 

• DInapoll Perferred Stochastic 

• hassan 

• ICHIMOKU SIGNAL TRADER 

• Index and ETF trading 

• Multiple Ribbon Demo 

• Stochastic OBV and Price Filter 

• Stochastic optimize 

• Stochastic Oscillator 

• Stochastics Trendlines 

• swing chart 

• TrendIngRIbbonArrowsADX 

More information: 


Updated on-line reference 


StochK - stochastic slow %K 
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StrCount 

- count the occurrences of substring within a string 


String manipulation 

(AFL 3.20) 


SYNTAX StrCount( "string", "substring" ) 

RETURNS NUMBER 

FUNCTION Function returns integer which is number of times substring was found in string. It is case 
sensitive. 


The function can be used for exampie to count the number of commas in comma-separated 
iist 

EXAMPLE 

tickers = "AAPL,MSFT, INTO" ; 

numtickers = 1 + StrCount ( tickers, ); 

SEE ALSO StrExtractO function , StrFind() function , StrFormat() function , StrLeft() function , StrLen() 
function , StrMidQ function , StrRepiace() function , StrRight() function 

References: 


The StrCount function is used in the foilowing formulas in AFL on-line library: 
• Optimal Weights 

More information: 


Updated on-line reference 


StrCount - count the occurrences of substring within a string 
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StrExtract 

- extracts given item (substring) from comma-separated string 


String manipulation 

(AFL 2.4) 


SYNTAX StrExtract( list, item, separator = ) 

RETURNS STRING 

FUNCTION Extracts given item (substring) from comma-separated iist of items, item is a zero-based 
index of the item in the iist (see aiso note beiow). 

If no substring at given index is found then empty string is returned (""). 

Usefui to retrive symbois from the iist obtained via GetCategorySymbois function. 

New in AmiBroker version 5.20: 

StrExtract( "string", item ) now accepts negative item values allowing to address items 
counting from the END of the list 

New in AmiBroker version 5.90: 

separator parameter allows to define separator other than comma 

EXAMPLE StrExtract ( "MSFT,AAPL,AMD,INTO" , 2 );// will return AMD 

StrExtract ( "MSFT,AAPL,AMD,INTO" , 0 );// will return MSFT 
StrExtract ( "MSFT,AAPL,AMD,INTC" , 200 );// will return empty string 


// 

// The example below shows how to use negative item 
// references (Version 5.20 AND up only!) 

tickers = "AAPL,MSFT, INTC" ; 

"The last item is " + StrExtract ( tickers, -1 ); 
printf ( "listing from the end of the list:n"); 

for ( item = -1; ( sym = StrExtract ( tickers, item ) ) item— 

) 

{ 

printf ( sym + "n" ); 

} 


SEE ALSO GETCATEGORYSYMBOLSO function 

References: 

The StrExtract function is used in the following formulas in AFL on-line library: 

• AFL_Glossary_1 

• AFL_Glossary_Converter 

• Baseline Relative Performance Watchlist charts V2 


StrExtract - extracts given item (substring) from comma-separated string 
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• Basket Trading System T101 

• BEANS-Summary of Holdings 

• Calculate composites for tickers in list files 

• Candle Identification 

• Count Tickers in Watchlist 

• Expiry day/days - Last thursday of month 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Heatmap V1 

• Herman 

• IB Backfiller 

• IBD relative strength database ranker 

• IBD relative strength database Viewer 

• MFE and MAE and plot trades as indicator 

• Optimal Weights 

• Ranking and sorting stocks 

• Ranking Ticker WatchList 

• Relative Strength 

• Rene Rijnaars 

• suresh 

• TWS auto-export Executions-file parser 

• TWS trade plotter 

• WLBuildProcess 

More information: 

Updated on-line reference 


StrExtract- extracts given item (substring) from comma-separated string 
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StrFind 

- find substring in a string 


String manipulation 

(AFL 2.5) 


SYNTAX StrFind( string, substring ) 

RETURNS NUMBER 

FUNCTION The StrFind function finds first occurrence of substring in string. 


Returns 0 if not found, otherwise returns character index (one-based) of first occurrence. 

EXAMPLE if ( StrFind ( Name(), ".L" ) ) 

{ 

printf ( "The " + Name() + " has .L suffix "); 

} 

else 


printf ( "The " + Name() + " does not have .L suffix " ); 

} 

SEE ALSO StrExtractQ function 

References: 


The StrFind function is used in the foilowing formulas in AFL on-line library: 

• AFL_Glossary_1 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Basket Trading System T101 

• BEANS-Summary of Holdings 

• Graphical sector stock amalysis 

• Heatmap VI 

• INTRADAY HEIKIN ASHI new 

• Pivots for Intraday Forex Charts 

• Visi-Trade 

More information: 


Updated on-line reference 


StrFind - find substring in a string 
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StrFormat 

- Write formatted output to the string 


String manipulation 

(AFL 2.5) 


SYNTAX StrFormat( formatstr,...) 

RETURNS STRING 

FUNCTION The StrFormat function formats and returns a series of characters and vaiues in the resuit 
string. 

If arguments follow the format string, the format string must contain specifications that 
determine the output format for the arguments. 

StrFormat and printf behave identically except that printf writes output to the window, while 
StrFormat does not write anything to output window but returns resulting string instead. 

StrFormat function is useful with conjunction with fputs function that allows to write string to 
a file. 

Note 1: for numbers always use %f, %e or %g formatting, %d or %x will not work because 
there are no integers in AFL. 

Note 2: as of now only numbers and arrays can now be used. For arrays 'selected value' is 
used 


Note 3: to print a single percent-sign character, you can not type % alone, you must use %%. 

EXAMPLE fh = fopen ( "Test. CSV" , "w" ); 

for ( i = 0; fh && i < 10; i++ ) 

{ 

text = StrFormat ( "Hello world, line %gn", i ); 
fputs ( text, fh ); 

} 


fclose ( fh ); 

SEE ALSO printfO function , fputsQ function 

References: 


The StrFormat function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• Advanced MA system 

• Advanced Trend Lines with S & R 

• Advisory NRx price chart display. 

• AFL_Glossary_1 

• ALJEHANI 

• Andrews PitchforkV3.3 

• Aroon The Advisor 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• Automatic Linear Trend Channel 


StrFormat - Write formatted output to the string 
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• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Price Crossover 

• babaloo chapora 

• BEANS-Summary of Floldings 

• Button trading using AB auto trading interface 

• changing period moving average 

• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• Colorfull Price 

• Continuous Contract Rollover 

• Coppock Trade Signal on Price Chart 

• Daily High Low in Advance 

• DateNumDateStr 

• Dave Landry PullBack Scan 

• DEBAJ 

• DiNapolis 3x Displaced Moving Averages 

• Elder safe Zone Long + short 

• Elder Triple Screen Trading System 

• Export All Daily Data to TXT with MS import format 

• Export EOD or Intraday to .csv file 

• Export Intraday Data 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• FastStochK FullStochK-D 

• Fib Fan Based on ZZ 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Fre 

• Gann level plotter 

• Gann Swing Charts in 3 modes with text 

• Harmonic Patterns 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• HH-LL-PriceBar 

• IB Backfiller 

• IBD relative strength database ranker 

• IBD relative strength database Viewer 

• ICHIMOKU SIGNAL TRADER 

• Intraday Fibonacii Trend Break System 

• Intraday Strength 

• Intraday Trend Break System 

• JEEVAN'S SRI CHAKRA 

• LunarPhase 

• Manual Bracket Order Trader 

• MFE and MAE and plot trades as indicator 

• MS Darvas Box with Exploration 

• Next Date Format 

• nifty 

• Option Calls, Puts and days till third friday. 

• Pivot End Of Day Trading System 

• Pivots And Prices 


StrFormat - Write formatted output to the string 
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• plot tomorrows pivots on an intraday database 

• prakash 

• Price Chart - Fundamental 

• PVT Trend Decider 

• Robert Antony 

• SAR-ForNextBarStop 

• Schiff Lines 

• shailu lunia 

• Square of Nine Roadmap Charts 

• Stochastic Oscillator 

• Super Trend Indicator 

• suresh 

• TD Sequential 

• TrendingRibbonArrowsADX 

• Vikram's Floor Pivot Intraday System 

• William's Alligator System II 

• WILSON RELATIVE PRICE CHANNEL 

• Zig-Hi Zap-Lo 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


StrFormat- Write formatted output to the string 


1088 



AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


StrLeft 

- extracts the leftmost part 


String manipulation 

(AFL 2.0) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


strleft( STRING, count) 

STRING 

Extracts the first (that is, ieftmost) cotvnf characters from STRING and returns a copy of the 
extracted substring. If count exceeds the string iength, then the entire string is extracted. 

newstring = strieft( string, 4 ); 


The StrLeft function is used in the foilowing formulas in AFL on-line library: 

• AFLGIossaryf 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• Auto-Optimization Framework 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• babaloo chapora 

• Basket Trading System T101 

• BEANS-Summary of Holdings 

• Binary to Decimal Converter 

• Button trading using AB auto trading interface 

• DateNumDateStr 

• Date_To_Num(), Time_To_Num() 

• Futures - Dollar Move Indicator 

• Futures - Dollar Move Today Indicator 

• Gordon Rose 

• Graphical sector stock amalysis 

• Heatmap VI 

• Herman 

• IB Backfiller 

• IBD relative strength database ranker 

• IBD relative strength database Viewer 

• Improved NH-NH scan / indicator 

• Manual Bracket Order Trader 

• MFE and MAE and plot trades as indicator 

• Pivot Finder 

• Ranking and sorting stocks 

• shailu lunia 

• Time Left in Bar 

• TWS auto-export Executions-file parser 

• TWS trade plotter 


StrLeft - extracts the leftmost part 
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More information: 

Updated on-line reference 


StrLeft- extracts the leftmost part 


1090 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


StrLen 

- string length 


String manipulation 

(AFL 1.5) 


SYNTAX strlen( STRING) 

RETURNS NUMBER 

FUNCTION calculates the length of the string 

EXAMPLE This function could be used for (for example) filtering out only 3 letter stock codes: buy = 

something AND strlen( name()) == 3; 

SEE ALSO 
References: 


The StrLen function Is used In the following formulas In AFL on-line library: 

• AFLGIossaryl 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Dollar Price Volatility Exploration 

• Basket Trading System T101 

• BEANS-Summary of Holdings 

• Binary to Decimal Converter 

• Button trading using AB auto trading Interface 

• Calculate composites for tickers In list files 

• Graphical sector stock amalysis 

• Heatmap VI 

• Herman 

• IB Backfiller 

• Manual Bracket Order Trader 

• Ranking and sorting stocks 

• Time Left In Bar 

• TWS auto-export Executlons-flle parser 

More information: 


Updated on-line reference 


StrLen - string length 
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StrMatch 

- string pattern/wildcard matching 


String manipulation 

(AFL 4.0) 


SYNTAX StrMatchC'string", "searchstring") 

RETURNS NUMBER 

FUNCTION The function returns TRUE (1) or FALSE (0) whenever string matches searchstring or not. 

Searchstring is can contain wiid-card characters such as: 

* - matches any string, inciuding empty strings 
? - matches any singie character 


This function is case sensitive (of course except wildcard characters). 

If you want case insensitive matching - convert both string and searchstring to lowercase or 
uppercase prior to matching (StrToLower/StrToUpper) 

EXAMPLE X = StrMatch ( "Every breath you take", "Every * you *"); // x will be 
TRUE 


X = StrMatch ( "Every step you make", "Every * you *" ); // x will be 


TRUE 

SEE ALSO StrFindO function , StrToLower() function , StrToUpper() function 

References: 

The StrMatch function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


StrMatch - string pattern/wildcard matching 
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StrMid 

- extracts part of the string 


String manipulation 

(AFL 2.0) 


SYNTAX StrMid( STRING, start, count) 

RETURNS STRING 

FUNCTION Extracts a substring of length cotvnf characters from STRING, starting at position start 
(zero-based). The function returns a copy of the extracted substring. 


New in version 5.90 - counf parameter can be skipped. If you skip counf then a substring 
starting from start \o the end of the string will be returned. 

EXAMPLE newstring = strmid( string, 1,2); 

SEE ALSO 
References: 


The StrMid function is used in the following formulas in AFL on-line library: 

• AFLGIossaryl 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Basket Trading System T101 

• DateNum_DateStr 

• Date_To_Num(), Time_To_Num() 

• Futures - Dollar Move Indicator 

• Futures - Dollar Move Today Indicator 

• Heatmap VI 

• IBD relative strength database ranker 

• IBD relative strength database Viewer 

• MFE and MAE and plot trades as indicator 

• TWS auto-export Executions-file parser 

• TWS trade plotter 

More information: 


Updated on-line reference 


StrMid - extracts part of the string 
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StrReplace String manipulation 

- String replace (AFL2 90) 


SYNTAX StrReplace( srcstring, oldsubstring, newsubstring ) 

RETURNS STRING 


FUNCTION This function returns a string with aii occurrences of oldsubstring in srcstring repiaced with 
the given newsubstring value. The string may grow or shrink as a resuit of the repiacement, 
that is oldsubstring and newsubstring do not have to be equai in iength. The function 
performs case-sensitive matches. 

EXAMPLE // the expression below will 

// result in string in which 'red' is replaced with 'brown' 
StrReplace ( "This fox is red", "red", "brown" ); 


SEE ALSO StrExtractQ function , StrFind() function , StrFormat() function , StrLeft() function , StrLenQ 
function , StrMidO function , StrRight() function , StrToDateTimeQ function , StrToLower() 
function , StrToNumO function , StrToUpper() function 

References: 


The StrReplace function is used in the foiiowing formuias in AFL on-iine iibrary: 

• AFLGiossaryt 

• AFL_Giossary_Converter 

• Caicuiate composites for tickers in iist fiies 

• Herman 

• WLBuiidProcess 


More information: 

Updated on-iine reference 


StrReplace - string replace 
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StrRight 

- extracts the rightmost part of the string 


String manipulation 

(AFL 2.0) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


StrRight( STRING, count) 

STRING 

Extracts the last (that is, rightmost) cotvnf characters from STRING and returns a copy of the 
extracted substring. If count exceeds the string iength, then the entire string is extracted. 

newstring = strright( string, 4 ); 


The StrRight function is used in the foilowing formuias in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• AFL_Glossary_1 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• BEANS-Summary of Holdings 

• Binary to Decimal Converter 

• DateNum_DateStr 

• Date_To_Num(), Time_To_Num() 

• Fibonacci Internal and External Retracements 

• Graphical sector stock amalysis 

• Heatmap VI 

• IBD relative strength database ranker 

• IBD relative strength database Viewer 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• MFE and MAE and plot trades as indicator 

• Pivots And Prices 

• Relative Strength Multichart of up to 10 tickers 

• Time Left in Bar 

• TWS auto-export Executions-file parser 

• TWS trade plotter 

More information: 


Updated on-line reference 


StrRight - extracts the rightmost part of the string 
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StrSort 

- sort comma-separated item list 


String manipulation 

(AFL 3.90) 


SYNTAX Sort( "tern,list,to,be,sorted", caseSensitive = True, separator = ) 

RETURNS STRING 


FUNCTION Perform sorting of comma-separated item iist given in a string. The comma is defauit 

separator, but it can be any separator that user chooses in separator argument. The sort is 
either case sensitive (caseSensitive=True) or not (caseSensitive=Faise). The sort order is 
ascending. The function returns string with items sorted. 

EXAMPLE EnableTextOutput ( 0 ) ; 


str = "MSFT,INTC,AAPL,GOOG"; 

printf ( "Before sort: + str + " ); 

str = StrSort ( str ); 


printf ( "After sort: + str + ); 

SEE ALSO Sort() function 

References: 


The StrSort function is used in the foliowing formulas in AFL on-line library: 

More information: 


Updated on-line reference 


StrSort - sort comma-separated item list 
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StrToDateTime 
- convert string to datetime 


String manipulation 

(AFL 2.80) 


SYNTAX StrToDateTime( "string") 

RETURNS NUMBER 

FUNCTION Converts string representing date/time vaiue to the corresponding DateTime number (that 
can be iater compared to output of DateTime() function for exampie). 

This function has shorter synonym: _DT function. 


VERSION 5.27 and above: It is important to understand that DateTime is not a simpie 
number but rather bitset and two datetime vaiues can only be reliably compared for equiity or 
inequality using == or != operators. Any other comparisions (less than/greater then) using 
normal operators > < can lead to wrong results, therefore to compare two datetime numbers 
you should use DateTimeDiff( arg1, arg2 ) which will return positive values if arg1 > arg2 and 
negative values if arg1 < arg2. 

EXAMPLE Buy = DateTime () == StrToDateTime ( "2005-Mar-05" ) ; 

SEE ALSO DATETIMEO function , DateTimeToStr() function , _DT() function 

References: 


The StrToDateTime function is used in the following formulas in AFL on-line library: 

• AFLGIossaryf 

• BEANS-Summary of Holdings 

• Improved NH-NH scan / indicator 

• TWS trade plotter 

More information: 


Updated on-line reference 


StrToDateTime - convert string to datetime 
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StrToLower 
- convert to lowercase 


String manipulation 

(AFL 2.80) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


StrToLower( "string") 

STRING 

This function converts input string to aii iower case. 

Title = StrToLower ( "MiXeD CaSe" ); 

StrToUpperO function 


The StrToLower function is used in the following formulas in AFL on-line library: 

• AFLGIossaryf 

• AFL_Glossary_Converter 

More information: 


Updated on-line reference 


StrToLower - convert to lowercase 
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StrToNum 

- convert string to number 


String manipulation 

(AFL 2.5) 


SYNTAX StrToNum( string) 

RETURNS NUMBER 

FUNCTION Converts string to number. 

EXAMPLE List = "123,456,789"; 


for ( i = 0; ( Item = StrExtract ( List, i 

{ 

printf ( "%gn", StrToNum( Item ) ); 

} 

SEE ALSO WRITEVALQ function 

References: 


; i++ ) 


The StrToNum function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Advanced Trend Lines with S & R 

• AFLGiossaryf 

• ALJEHANI 

• AutoTrade using an Expioration 

• BEANS-Summary of Hoidings 

• Daiiy High Low in Advance 

• DateNum_DateStr 

• Date_To_Num(), Time_To_Num() 

• Expiry day/days - Last thursday of month 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Graphicai sector stock amaiysis 

• Heatmap V1 

• IBD reiative strength database ranker 

• IBD reiative strength database Viewer 

• Market Profiie 

• MFE and MAE and piot trades as indicator 

• Square of Nine Roadmap Charts 

• suresh 

• TD Sequentiai 

• TWS auto-export Executions-fiie parser 

• TWS trade piotter 

• Woodie's CCI Panei Fuii Stats 

• Woodie's Price Panei With Woodie's Pivots 


More information: 


Updated on-iine reference 


StrToNum - convert string to number 
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StrToUpper 
- convert to uppercase 


String manipulation 

(AFL 2.80) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


StrToUpper( "string") 

STRING 

This function converts input string to aii upper case. 

Title = StrToUpper ( "MiXeD CaSe" ); 

StrToLowerO function 


The StrToUpper function is used in the foliowing formulas in AFL on-line library: 

• AFL_Glossary_1 

• AFL_Glossary_Converter 

• Auto Trader Basic Flow 


More information: 


Updated on-line reference 


StrToUpper - convert to uppercase 
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StrTrim 

- trim whitespaces from the string 


String manipulation 

(AFL 3.90) 


SYNTAX StrTrim( "string", "targets", side = 3 ) 

RETURNS STRING 


FUNCTION The function trims extra characters (specified in "targets") from either ieft (1), right(2) or 
both(3) sides of the string. If "targets" parameter is an empty string, then function trims 
whitespaces (i.e. space, tab, newiine) 

EXAMPLE EnableTextOutput ( 0 ) ; 


str = "== ==string with extra chars== =="; 


printf ( "Before trim; + str + "'\n" ); 


str = StrTrim ( str, " =" ); 

printf ( "After trim: '" + str + "'" ) ; 

SEE ALSO 
References: 

The StrTrim function is used in the foilowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 


StrTrim - trim whitespaces from the string 
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Study 

- reference hand-drawn study 


Miscellaneous functions 

(AFL 1.5) 


SYNTAX Study( STUDYID, CHARTID = 1, scale = -1 ) 

RETURNS ARRAY 

FUNCTION generates an array equivalent to a trendline study drawn by the user - allows detecting 
trendline breakouts from AFL. 

STUDYID is a two-character identifier of the study, identifiers are: "UP" - uptrend, "DN" - 
downtrend, "SU" - support, "RE" - resistance, "ST" - stop loss, however you can use ANY 
identifiers (there are no limitations except that AmiBroker accepts only 2 letter codes). 
CHARTID - identifies the chart pane where the study was drawn - you can find out what is 
the chart ID for given chart by looking in Parameters dialog. Axes & Grid, Miscellaneous: 
Chart ID or using GetChartlD() AFL function. 

Scale - this parameter specifies which scale should be used: 


• scale = -1 : automatic (default value) - either linear or logarithmic depending on 
actual chart setting, chart Is specified by chartID 

• scale = 0 : linear scale 

• scale = 1 : logarithmic scale 


More information about this function is inciuded in the Tutoriai: Using Studies in AFL 
formuias 

EXAMPLE // this example plots filled area between 
// support (SU) and resistance (RE) lines 


Plot (C, "Price", colorBlack, styleCandle ); 

SU = Study ("SU", GetChartIDO ); 
re = Study ("RE", GetChartIDO ) ; 

PlotOHLC ( re, re, su, su, colorYellow,styleCloud ); 


SEE ALSO GETCHARTIDO function 

References: 


The Study function is used in the foilowing formulas in AFL on-line library: 
• Plot visual stop / target ratio. 

More Information: 


Updated on-line reference 


Study - reference hand-drawn study 
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Sum 

- sum data over specified number of bars 


SYNTAX Sum( ARRAY, periods ) 
RETURNS ARRAY 


FUNCTiON Calculates a cumulative sum of the ARRAY for the specified number of lookback periods 
(Including today). The function accepts periods parameter that can be constant as well as 
time-variant (array). 

EXAMPLE The formula "sum( CLOSE, 14 )" returns the sum of the preceding 14 closing prices. A 
14-perlod simple moving average could be written "sum(C,14) /14." 

SEE ALSO CUMQ function 

Comments: 


Graham Kavanagh 

Sum adds up the last "n" number of bars. It sums whatever you put Into the first 

gkavanagh@e-wlre.net.au 

part of the sum formula. 

2004-08-09 07:52:41 

Cum(1) adds 1 to the previous value of Cum, so the first bar Is 1 and It just 
keeps adding one to the last bar value of cum(1). 

You can use Cum to add anything, like how many times you get rising days In 
the entire chart: 


Rise = C>0; //this gives results of 0 or 1 

TotalRIse = Cum(Rlse); 


You could limit this as well to time periods, or any other condition Example 
would be one for total rise days since 1995: 


RecentRlse = C>0 and Year()>=1995; //this gives results of 0 or 1 

TotalRIse = Cum(RecentRlse); 


If you wanted to know how many rising days In the last 12 bars you would use: 


LastRlses = Sum(Rlse,12); 


Hope this helps 


References: 


The Sum function Is used In the following formulas In AFL on-line library: 

• Pivots And Prices And Swing Volume 

• Adaptive Relative Vigour Index 

• Against all odds 

• AJDX system 

• Alpha and Beta and R_Squared Indicator 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 


Sum - sum data over specified number of bars 
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• AR_Prediction.afl 

• Auto-Optimization Framework 

• Automatic Trendiines using muitipie timeframes 

• Boiiinger band normaiization 

• Buff Voiume Weighted Moving Averages 

• Buyer Selier Force 

• CandieStick Comentary-Fleip needed 

• CandieStochastics 

• Chaikin Money Fiow 

• Chande Momentum Osciiiator 

• Channei/S&R and trendiines 

• Coie 

• Connors TPS 

• crBeta 

• crMathLib 

• DeMarker 

• Dynamic Momentum Index 

• Dynamic Momentum Index 

• Dynamtic Momentum Index 

• ekeko price chart 

• Elder safe Zone Long -i- short 

• Elder Triple Screen Trading System 

• Elder's SafeZone Stop 

• ElderSafeZoneStopLong 

• ElderSafeZoneStopShort 

• Fib CMO 

• Fisher Relative Vigour Index 

• Fre 

• Frequency distribution of returns 

• Heatmap V1 

• Hilbert Study 

• Hurst Constant 

• Intraday Average Volume 

• Kiss and Touch with the Modified True Range 

• Linear Regression Line & Bands 

• MACD commentary 

• Multicycle 1.0 

• Perceptron 

• Performance Check 

• Peterson 

• Polarized Fractal Efficiency 

• Projection Oscillator 

• QP2 Float Analysis 

• Range Expansion Index 

• Regression Analysis Line 

• Relative Vigour Index 

• Relative Vigour Index 

• RSI of Weekly Price Array 

• RSIS 

• Sector Tracking 

• Sony 

• Stochastic of Weekly Price Array 


Sum - sum data over specified number of bars 
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• Stochastic Relative Vigour Index 

• TD REI 

• TD sequential 

• TD Sequential 

• The Saturation Indicator D_sat 

• Time Frame Weekly Bars 

• Time segment value 

• Tracking Error 

• Tracking Error 

• Trailing Stop Loss 

• Trend Analysis_Comentary 

• Trend Continuation Factor 

• Trend Exploration: Count Number of New Highs 

• Trend Following System 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Vertical Horizontal Filter 

• Vertical Horizontal Filter (VHF) 

• Visualization of stoploses and profit in chart 

• Volume Weighted Moving Average 

• Volume wieghted moving average 

• VWAP - Volume Weighted Average Price 

• VWAP versus Average Price 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• z-distance from vwap 

More information: 

Updated on-line reference 


Sum- sum data over specified number of bars 
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tan 

- tangent function 


Math functions 

(AFL 1.0) 


SYNTAX tan( NUMBER) 
tan(ARRAY) 

RETURNS NUMBER,ARRAY 

FUNCTION Returns the tangent of NUMBER or ARRAY. This function assumes that the ARRAY vaiues 
are in radians 


EXAMPLE 

SEE ALSO atan() function 

References: 


The tan function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Andrews Pitchfork 

• Andrews PitchforkV3.3 

• AR_Prediction.afi 

• Cybernertic Fliibert Sine Wave 

• DMI Spread Index 

• Dominant Cycle Phase 

• Gabriel Linear Regression Angle Indicator 

• Heatmap VI 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• Hilbert Study 

• John Ehler 

• Moving Average "Crash" Test 

• Multiple sinus noised 

• Schiff Lines 

• Signal to Noise 

• Sine Wave Indicator 

• Smoothed Adaptive Momentum 

• Three Pole Butterworth 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

More information: 

Updated on-line reference 


tan - tangent function 
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tanh 

- hyperbolic tangent function 

SYNTAX tanh( NUMBER) 

tanh( ARRAY) 

RETURNS NUMBER, 

ARRAY 

FUNCTION Returns the hyperbolic tangent of NUMBER or ARRAY. This function assumes that the 
ARRAY values are in radians. 

EXAMPLE 

SEE ALSO 
References: 

The tanh function is used in the following formulas in AFL on-line library: 

More information: 

Updated on-line reference 


Math functions 

(AFL 2.80) 


tanh - hyperbolic tangent function 


1107 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


TEMA 

- triple exponential moving average 


Moving averages, summation 

(AFL 2.0) 


SYNTAX tema( ARRAY, periods) 

RETURNS ARRAY 

FUNCTiON Calculates triple exponentially smoothed average - TEMA. The function accepts 
time-variable periods. 

EXAMPLE TEMA( Close, 5 ) 

SEE ALSO MA(), EMA(), WMA(), DEMA() 

Comments: 


Graham Waiker 

//TEMA can be Implemented via EMA: 

helpman@dodo.com.au 
2005-02-18 04:51:33 

Len=10; 

MyTEMA = 3 * EMA(Close,len) - 3 * EMA(EMA(Close,len),Len) -h 
EMA(EMA(EMA(C lose,len),len),len); 


Plot(MyTEMA,"MyTEMA",colorBlue); 


// for comparison only 

Plot( TEMA( Close, Len ), "Built-In TEMA", colorRed ); 


References: 


The TEMA function Is used In the following formulas In AFL on-line library: 

• Auto-Optimizatlon Framework 

• Average Price Crossover 

• babaloo chapora 

• Bad Tick Trim on 5 sec database 

• Balance of Power 

• balance of power 

• BMTRIX Intermediate Term Market Trend Indicator 

• Bull/Bear Volume 

• Dahl Oscillator modified 
• DEBAJ 

• Elder Impulse Indicator V2 

• Heatmap V1 

• ModIfled-DVI 

• Volume Occllator 

More information: 

Updated on-line reference 


TEMA - triple exponential moving average 
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ThreadSleep 

- suspend thread for specified number of miiiiseconds 


Miscellaneous functions 

(AFL 3.50) 


SYNTAX ThreadSleep( milliseconds) 

RETURNS NOTHING 

FUNCTION ThreadSleep( milliseconds ) suspends current thread for specified number of milliseconds 
(maximum is 100 ms). Works only from NON-UI threads. When called from Ul thread the 
function does NOTHING and returns immediatelly. Please do NOT abuse this function. Using 
it may negatively impact performance. The function is provided for advanced users to 
implement inter-thread synchronization. For more details see Tutorial: Effective use of 
multi-threading 

EXAMPLE 


SEE ALSO StaticVarCompareExchangeO function 

References: 


The ThreadSleep function is used in the following formulas in AFL on-line library: 

More Information: 


Updated on-line reference 


ThreadSleep - suspend thread for specified number of milliseconds 
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TimeFrameCompress 

- compress single array to given time frame 


Time Frame functions 

(AFL 2.5) 


SYNTAX TimeFrameCompress( array, interval, mode = compressLast) 

RETURNS ARRAY 

FUNCTiON The TimeFrameCompress function compresses single array to given interval using given 
compression mode available modes: 

• compressLast - last (close) value of the array within interval 

• compressOpen - open value of the array within interval 

• compressHigh - highest value of the array within interval 

• compressLow - lowest value of the array within interval 

• compressVolume - sum of values of the array within interval 

To expand compressed array you should use the TimeFrameExpand function. 

The TimeFrameCompress function is provided for completeness and it can be used when 
you want to compress single array without affecting built-in OHLC.V arrays. If you call 
TimeFrameCompress it does not affect results of other functions (opposite to 

TimeFrameSet). 


For more information check Tutorial: Multiple time frame support 
EXAMPLE wc = TimeFrameCompress ( Close, inWeekly ); 


/* now the time frame is still unchanged (say daily) and our MA will 
operate on daily data */ 
dailyma = MA ( C, 14 ) ; 


/* but if we call MA on compressed array, it will give MA from other 
time frame */ 

weeklyma = MA ( wc, 14 ); // note that argument is time-compressed 
array 


Plot ( dailyma, "DailyMA", colorRed ) ; 

weeklyma = TimeFrameExpand ( weeklyma, inWeekly ); // expand for 
display 


Plot ( weeklyma, "WeeklyMA", colorBlue ); 

SEE ALSO TimeFrameExpandO function 

References: 


The TimeFrameCompress function is used in the following formulas in AFL on-line library: 

• Intraday Range and Periods Framer 

• Market Breadth Chart-In-Chart 

• Volume Color with Dynamic Limit 


TimeFrameCompress - compress single array to given time frame 
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More information: 

Updated on-line reference 


TimeFrameCompress- compress single array to given time frame 
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TimeFrameExpand 

- expand time frame compressed array 


Time Frame functions 

(AFL 2.5) 


SYNTAX TimeFrameExpand( array, interval, mode = expandLast) 

RETURNS ARRAY 

FUNCTiON The TimeFrameExpand function expands time-compressed array from /nferva/time frame to 
base time frame (/nferva/parameter must match the vaiue used in TimeFrameCompress or 
TimeFrameSet) 

The TimeFrameExpand is used to decompress array variabies that were created in different 
time frame. Decompressing is required to properly display the array created in different time 
frame. For example if you want to display weekly moving average it must be 'expanded' so 
the data of one weekly bar covers five daily bars (Monday-Friday) of corresponding week. 

Available modes: 


• expandLast - the compressed value is expanded starting from last bar within given 
period (so for example weekly close/high/low is available on Friday's bar) 

• expandFirst - the compressed value is expanded starting from first bar within given 
period (so for example weekly open is available from Monday's bar) 

• expandPoint - the resulting array gets not empty values only for the last bar within 
given period (all remaining bars are Null (empty)). 

Caveat: expandFirst used on price different than open may look into the future. For example 
if you create weekly FIIGFI series, expanding it to daily interval using expandFirst will enable 
you to know on MONDAY what was the high for entire week. 

For more information check Tutorial: Multiple time frame support 
EXAMPLE wc = TimeFrameCompress ( Close, inWeekly ); 

/* now the time frame is still unchanged (say dally) and our MA will 
operate on daily data */ 
dailyma = MA ( C, 14 ) ; 

/* but if we call MA on compressed array. It will give MA from other 
time frame */ 

weeklyma = MA ( wc, 14 ); // note that argument is time-compressed 
array 

Plot ( dailyma, "DailyMA", colorRed ) ; 

weeklyma = TimeFrameExpand ( weeklyma, inWeekly ); // expand for 
display 

Plot ( weeklyma, "WeeklyMA", colorBlue ); 

SEE ALSO TimeFrameSetO function , TimeFrameRestore() function 


TimeFrameExpand - expand time frame compressed array 
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References: 

The TimeFrameExpand function is used in the foiiowing formuias in AFL on-iine iibrary: 

• 2 Timeframes Candiestick Bar Chart 

• 3TF Candiestick Bar Chart 

• Alternative ZIG type function, multi TF 

• Automatic Trendlines using multiple timeframes 

• Channel/S&R and trendlines 

• Daily Fligh Low in Advance 

• EKEKO SAR-MF 

• Elder Impulse Indicator 

• Elder Impulse Indicator V2 

• Elder Triple Screen Trading System 

• IFT of RSI - Multiple TimeFrames 

• Index and ETF trading 

• Intraday Range and Periods Framer 

• Pivot Point with S/R Trendlines 

• Rea Time Daily Price Levels 

• Twiggs money flow weekly 

• Volume Color with Dynamic Limit 

More information: 

Updated on-line reference 


TimeFrameExpand- expand time frame compressed array 
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TimeFrameGetPrice 

- retrieve O, H, L, C, V values from other time frame 


Time Frame functions 

(AFL 2.5) 


SYNTAX TimeFrameGetPrice( pricefield, interval, shift = 0, mode = expandFirst ) 

RETURNS ARRAY 

FUNCTiON The TimeFrameGetPrice - retrieves OHLCV fields from other time frames. This works 
immediatellv without need to call TimeFrameSet at all. 

First parameter - pricefield- is one of the following: "O", "H", "L", "C", "V", "I" (open interest). 

Interval'\s bar interval in seconds. You can use pre-defined interval constants: in1 Minute, 
inSMinute, in15Minute, InHourly, InDaily, inWeekly, InMonthly. Or integer multiples like 
(3*in1 Minute) for 3 minute bars 

s/?/ff allows to reference past (negative values) and future (positive values) data in higher 
time frame. For example -1 gives previous bar's data (like in Ref function but this works in 
higher time frame). 

mode - one of available modes: 

• expandLast - the compressed value is expanded starting from last bar within given 
period (so for example weekly close/high/low is available on Friday's bar) 

• expandFirst - the compressed value is expanded starting from first bar within given 
period (so for example weekly open is available from Monday's bar) 

• expandPoint - the resulting array gets not empty values only for the last bar within 
given period (all remaining bars are Null (empty)). 

Note these functions work like these 3 nested functions: 

TimeFrameExpand( Ref( TimeFrameCompress( array, interval, 
compress(depending on field used) ), shift ), interval, expandFirst 
) 


therefore, if shift = 0 compressed data may look into the future ( weekly high can be known 
on monday ). If you want to write a trading system using this function please make sure to 
reference PAST data by using negative shift value. 

The only difference is that TimeFrameGetPrice is 2x faster than nested Expand/Compress. 

For more information check Tutorial: Multiple time frame support 

EXAMPLE // Example 1 . get previous week Open price 

TimeFrameGetPrice ( "0", inWeekly, -1 ) 

// Example 2. get weekly Close price 3 weeks ago 

TimeFrameGetPrice ( "C", inWeekly, -3 ) 

// Example 3. get weekly High price 2 weeks ago 
TimeFrameGetPrice ( "H", inWeekly, -2 ) 


TimeFrameGetPrice - retrieve O, H, L, C, V values from other time frame 
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11 Example 4. get this week Open price. 

TimeFrameGetPrice ( "0", inWeekly, 0 ) 

// Example 5. get previous Day High when working on intraday data 
TimeFrameGetPrice ( "H", inDaily, -1 ) 

SEE ALSO TimeFrameSetO function 

References: 

The TimeFrameGetPrice function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Pivots And Prices And Swing Voiume 

• Heatmap V1 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• Market Profile 

• Pivots for Intraday Forex Charts 

• plot tomorrows pivots on an intraday database 

• Robert Antony 

• Vikram's Floor Pivot Intraday System 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


TimeFrameGetPrice- retrieve O, H, L, C, V values from other time frame 
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TimeFrameMode 

- switch time frame compression mode 


Time Frame functions 

(AFL 2.80) 


SYNTAX TimeFrameMode( mode) 

RETURNS NOTHING 

FUNCTiON Switches time frame functions to different operating modes. Where mode is one of 0, 1,2, 3, 
or 4. 

• TimeFrameMode( 0 ); 

- switches time frame functions to time-based operation (the defauit) 

• TimeFrameMode( 1 ); 

- switches time frame functions to N-tick operation (positive values passed to 
TimeFrameSet are treated now as N-tick) 

• TimeFrameMode( 2 ); 

- switches time frame functions to N-volume bar operation (positive values passed to 
TimeFrameSet are treated nowas N-volme bars) 

• TimeFrameMode( 3 ); 

- switches time frame functions to N-Range bar operation (positive values passed to 
TimeFrameSet are treated now as N-range bars) where N is expressed in DOLLARS 
(This mode is left in 5.14 and above for backward compatiblity only, see next) 

• TimeFrameMode( 4); 

- switches time frame functions to N-Range bar operation (positive values passed to 
TimeFrameSet are treated now as N-range bars) where N is expressed in TickSize 
units (this is default mode of operation of range bars in 5.14 and above). 

Note: N-volume bars are very different from time-based bars(compression of data to 
N-volume bar may actually deliver MORE output bars - for example if one tick is 1000 shares 
and you have specified 100V bars then single tick will be expanded to TEN 100V bars - ten 
times original size) 

TimeFrame functions are protected against array overrun and will not decompress beyond 
original array size (you will get an "Error 47. N-volume bar compressed data longer than 
base time frame"). Also switching main time frame to some weird N-volume bar value will 
result in limiting the output to maximum twice original data size(without error message). 

You should keep that in mind and avoid using too small N-volume bar intervals that could 
lead to such condition. Also due to the nature of N-volume bars the only TimeFrameSet() 
function will yield correct N-volume bar values, TimeFrameGetPrice() may give slightly 
distorted results. 


It is also possible to use n-volume bars in TimeFrame functions without calling 
TimeFrameModeO - it is then necessary to specify n-volume bars as negative number offset 
by -1000000 (minus one million): 

TimeFrameSet( -1000000 - 2000 ); 

EXAMPLE TimeFrameMode ( 2 ) ; 

TimeFrameSet ( 50000 ); // 50'000 share bars.. 

//...do something ... 


TimeFrameMode - switch time frame compression mode 
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TimeFrameRestore () ; 

SEE ALSO TimeFrameSetO function , TimeFrameRestore() function 

References: 

The TimeFrameMode function is used in the foliowing formulas in AFL on-line library: 

• Bad Tick Trim on 5 sec database 
More information: 

Updated on-line reference 


TimeFrameMode- switch time frame compression mode 
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TimeFrameRestore 

- restores price arrays to original time frame 


Time Frame functions 

(AFL 2.5) 


SYNTAX TimeFrameRestore( tradeprices = Faise ) 

RETURNS NOTHING 

FUNCTiON The TimeFrameRestore function restores price arrays repiaced by TimeFrameSet. 

Note that oniy OHLC, V, 01 and Avg buiit-in variabies are restored to originai time frame 
when you caii TimeFrameRestore(). 

All other variables created when being in different time frame remain compressed. 

To de-compress them to original interval you have to use TimeFrameExpand. 
Tradeprice argument should be set to false. 

EXAMPLE TimeFrameSet ( inSMinute ); // switch to 5 minute frame 


/* MA now operates on 5 minute data, ma5_13 holds time-compressed 13 
bar MA of 5min bars */ 


SEE ALSO 
Comments: 


ma5_13 = MA( C, 13 ) ; 

TimeFrameRestore 0; // restore time frame to original 

TimeFrameSet ( inHourly ); // switch now to hourly 

mah_9 = EMA ( C, 9 ); // 9 bar moving average from hourly data 

TimeFrameRestore 0; // restore time frame to original 

Plot ( Close, "Price", colorWhite, styleCandle ); 

// plot expanded average 

Plot ( TimeFrameExpand ( ma5_13, inSMinute), "13 bar moving average 
from 5 min bars", colorRed ) ; 

Plot ( TimeFrameExpand ( mah_9, inHourly), "9 bar moving average from 
hourly bars", colorRed ); 

TimeFrameSetO function 


Tomasz Janeczko 

TimeFrameRestore and RestorePriceArrays 

tj -at- 

is essentially the same function. So please note that calling TimeFrameRestore also 

amibroker.com 

resets the ticker set by eventual previous call to SetForeign() 

2004-07-10 


06:19:47 



TimeFrameRestore - restores price arrays to original time frame 
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References: 

The TimeFrameRestore function is used in the foiiowing formuias in AFL on-iine iibrary: 

• 2 Timeframes Candiestick Bar Chart 

• 3TF Candiestick Bar Chart 

• Alternative ZIG type function, multi TF 

• Automatic Trendlines using multiple timeframes 

• Channel/S&R and trendlines 

• Daily Fligh Low in Advance 

• EKEKO SAR-MF 

• Elder Impulse Indicator 

• Elder Impulse Indicator V2 

• Elder Triple Screen Trading System 

• Hull Multiple Moving Averages 

• IFT of RSI - Multiple TimeFrames 

• Improved NH-NH scan / indicator 

• Lagging MA-Xover 

• Market Breadth Chart-In-Chart 

• Pivot Point with S/R Trendlines 

• Price with Woodies Pivots 

• Rea Time Daily Price Levels 

• SUPER PIVOT POINTS 

• Twiggs money flow weekly 

More information: 

Updated on-line reference 


TimeFrameRestore- restores price arrays to original time frame 
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TimeFrameSet 

- switch price arrays to a different time frame 

SYNTAX TimeFrameSet( interval) 

RETURNS NOTHING 

FUNCTION The TimeFrameSet replaces current price/volume arrays: open, high, low, close, volume, 

openint, avg with time-compressed bars of specified interval once you switched to a different 
time frame all calculations and built-in indicators operate on selected time frame. To get back 
to original interval call TimeFrameRestoreQ function. Before calling TimeFrameSet again in 
the same formula with different interval you have to restore original time frame first using 
TimeFrameRestore. 

/nferva/defines time frame interval in seconds. So 60 means 1-minute. For the convenience 
the following interval constants are pre-defined: 

• in1 Minute = 60 

• inSMinute = 5 * 60 

• in15Minute = 15 * 60 

• InHourly = 3600 

• InDaily = 24 * 3600 

• inWeekly = 5 * 24 * 3600 -h 1 = 432001 

• InMonthly = 25 * 24 * 3600 -h 1 = 2160001 

• inQuarterly (new in 5.20) 

• InYearly (new in 5.20) 

To get other intervals you can use multiple of pre-defined intervals, for example: ( 

3*in1 Minute ) gives 3 minute bars. Or you can use 3 * InDaily for 3-day bars. 

New in version 4.70 and above: You can also use NEGATIVE values for N-tick charts: -5 
fives 5-tick chart. Note that N-tick compression works correct only if you have 1-tick base 
time interval selected in database settings. 

You can also use TimeFrameSet to create N-volume bars as well as Range bars. See 
TimeFrameModeO function for more details. 

VERY IMPORTANT: 

inWeekly constant is now 432001 ( 5*inDaily -i- 1 ) - in previous version it was 432000 
InMonthly constant is now 2160001 ( 25*inDaily -i-1 ) - in previous version it was 2160000 
It is changed because now N-day custom intervals are supported and they will interfere with 
weekly/monthly. 

Note that 5*inDaily is now DIFFERENT than inWeekly. 5*inDaily creates 5-day bars that DO 
NOT necesarily cover Monday-Friday while inWeekly ALWAYS creates bars that begin on 
Monday and end on Friday. Also 25*inDaily creates 25-day bars that DO NOT necesarily 
represent full month, while InMonthly always begins with first day of the month and ends at 
the last day of the month 

Once you switch the time frame using TimeFrameSet , all AFL functions operate on this time 
frame until you switch back the time frame to original interval using TimeFrameRestore or 
set to different interval again using TimeFrameSet. It is good idea to ALWAYS call 


Time Frame functions 

(AFL 2.5) 


TimeFrameSet - switch price arrays to a different time frame 
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TimeFrameRestore when you are done with processing in other time frames. 

When time frame is switched to other than originai intervai the resuits of aii functions caiied 
since TimeFrameSet are time-compressed too. If you want to dispiay them in originai time 
frame you wouid need to 'expand' them as described iater. Variabies created and assigned 
before caii to TimeFrameSetQ remain in the time frame they were created. This behaviour 
aiiows mixing uniimited different time frames in singie formuia. 

Please note that you can only compress data from shorter interval to longer interval. So 
when working with 1-minute data you can compress to 2, 3, 4, 5, 6, ....N-minute data. But 
when working with 15 minute data you can not get 1-minute data bars. In a similar way if you 
have only EOD data you can not access intraday time frames. 

For more information check: Tutorial: Multiple time frame support in AFL 

EXAMPLE TimeFrameSet ( inSMinute ); // switch to 5 minute frame 

/* MA now operates on 5 minute data, ma5_13 holds time-compressed 13 
bar MA of 5mln bars */ 

ma5_13 = MA( C, 13 ) ; 

TimeFrameRestore 0; // restore time frame to original 

TimeFrameSet ( inHourly ); // switch now to hourly 

mah_9 = EMA ( C, 9 ); // 9 bar moving average from hourly data 

TimeFrameRestore 0; // restore time frame to original 

Plot ( Close, "Price", colorWhite, styleCandle ); 

// plot expanded average 

Plot ( TimeFrameExpand ( ma5_13, inSMinute), "13 bar moving average 
from 5 min bars", colorRed ) ; 

Plot ( TimeFrameExpand ( mah_9, inHourly), "9 bar moving average from 
hourly bars", colorRed ); 

SEE ALSO TimeFrameRestoreO function , TimeFrameExpand() function , TimeFrameGetPrice() function 

Comments: 


Tomasz Janeczko 

TimeFrameSet(in15Minute); 

tj -at- amibroker.com 

MAI 0_15Min=MA(Close,10); 

2004-06-03 04:35:37 

TimeFrameRestoreO; 


Buy=Cross( MA(Close,5), TimeFrameExpand(MA10_15Min, in15Minute)); 


TimeFrameSet- switch price arrays to a different time frame 
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References: 

The TimeFrameSet function is used in the foiiowing formuias in AFL on-iine iibrary: 

• 2 Timeframes Candiestick Bar Chart 

• 3TF Candiestick Bar Chart 

• Aiternative ZIG type function, muiti TF 

• Automatic Trendiines using muitipie timeframes 

• Bad Tick Trim on 5 sec database 

• Channei/S&R and trendiines 

• Coior Price Bar - Impuise System 

• Coior Price Bars with MACD Flistogram Changes 

• Daiiy Fligh Low in Advance 

• EKEKO SAR-MF 

• Eider Impuise Indicator 

• Eider Impuise Indicator V2 

• Elder Tripie Screen Trading System 

• Hull Multiple Moving Averages 

• IFT of RSI - Multiple TimeFrames 

• Improved NH-NH scan / indicator 

• Lagging MA-Xover 

• Market Breadth Chart-In-Chart 

• Pivot Point with S/R Trendlines 

• Price with Woodies Pivots 

• Rea Time Daily Price Levels 

• SUPER PIVOT POINTS 

• Twiggs money flow weekly 

More information: 

Updated on-line reference 


TimeFrameSet- switch price arrays to a different time frame 
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TimeNum 

- get current bar time 


Date/Time 

(AFL 2.0) 


SYNTAX 

TimeNumO 

RETURNS 

ARRAY 

FUNCTiON 

Returns the array with numbers that represent quotation time coded as follows: 
10000 * hour - 1 - 100 * minute + second, so 12:37:15 becomes 123715 

EXAMPLE 

TimeNumO 

SEE ALSO 

Hour(), MinuteO, Second(), TimeNumQ 

References: 



The TimeNum function is used in the foilowing formulas in AFL on-line library: 

• AFL_Glossary_1 

• AR_Prediction.afl 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Bad Tick Trim on 5 sec database 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• Continuous Contract Rollover 

• Date_To_Num(), Time_To_Num() 

• Export EOD or Intraday to .csv file 

• Intraday Range and Periods Framer 

• Lagging MA-Xover 

• MFE and MAE and plot trades as indicator 

• Moving Averages NoX 

• Now Send Push Notifications From Amibroker 

• Rea Time Daily Price Levels 

• suresh 

• Time Left in Bar 

• Time Left to Current Bar 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• TWS auto-export Executions-file parser 

• VWAP - Volume Weighted Average Price 

• VWAP versus Average Price 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

More information: 

Updated on-line reference 


TimeNum - get current bar time 
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Trin 

- traders (Arms) index 


Composites 

(AFL 1.2) 


SYNTAX TrinQ 

RETURNS ARRAY 

FUNCTION Calculates TRIN (Arms Index) Indicator. 

NOTE: All bullt-ln a/d Indicators (AdLlne/TrIn) work only with composites calculated Inside 
AmiBroker http://www.amlbroker.eom/newsletter/04-2000.html 

If you are using QP2 database for example you should use QP2's own symbols for 
advances/decllnes. 

INY-A, INY-D, INY-AV, INY-DV 

The formula for NYSE TRIN using QP2 database Is: 


ArmsIndex = ( Foreign("!NY-A", "C") / Foreign("!NY-D", "C") ) / ( 

Foreign("!NY-AV", "C") / Foreign("INY-DV","C" ) ); 

Plot( Armsindex, "TRIN", colorRed ); 

EXAMPLE trln() 

SEE ALSO 
References: 


The Trin function Is used In the following formulas In AFL on-line library: 

More information: 


Updated on-line reference 


Trin - traders (Arms) index 


1124 


AmiBroker 6.00 User's Guide AmiBroker Formula Language (AFL) 

TRIX Indicators 

- triple exponential smoothed price 


SYNTAX 

trix( periods = 9 ) 

RETURNS 

ARRAY 

FUNCTION 

Calculates the TRIX indicator (with averaging range of periods). 

EXAMPLE 

trix( 12 ) 

SEE ALSO 


References: 



The TRIX function is used in the foliowing formulas in AFL on-line library: 

• TRIX 

• Trix Bars number 

• TRIXXX 

More information: 

Updated on-line reference 


TRIX - triple exponential smoothed price 
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Trough 
- trough 


Basic price pattern detection 

(AFL 1.1) 


SYNTAX Trough(ARRAY, change, n = ^} 

RETURNS ARRAY 

FUNCTiON Gives the value of ARRAY n-th trough(s) ago. This uses the Zig Zag function (see Zig Zag) 
to determine the troughs. Caveat: this function is based on Zig-Zag indicator and may look 
into the future. 

EXAMPLE trough(close,5,1) 

SEE ALSO 
Comments: 


Tomasz Janeczko 

Zig/Peak/Trough functions work correctly for ARRAYS containing data greater than 

tj -at — amibroker.com 

zero. 

2007-09-24 03:31:47 



References: 


The Trough function is used in the following formulas in AFL on-line library: 

• Advanced Trend Lines with S & R 

• Andrews Pitchfork 

• Andrews PitchforkV3.3 

• Automatic Trend-line 

• Constant Trendline Plot 

• Gartley 222 Pattern Indicator 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• JEEVAN'S SRI CHAKRA 

• MACD commentary 

• Pivot Point with S/R Trendlines 

• Schiff Lines 

• Support Resistance levels 

• Tom DeMark Trend Lines 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Full Stats 

• ZigZag Retracements 

More information: 

Updated on-line reference 


Trough - trough 


1126 





AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


TroughBars 
- bars since trough 


Basic price pattern detection 

(AFL 1.1) 


SYNTAX TroughBars(ARRAY, change, n = ^) 
RETURNS ARRAY 


FUNCTiON Plots the number of bars that have passed from the n-th trough. This uses the Zig Zag 

function (see Zig Zag) to determine the troughs. Caveat: this function is based on Zig-Zag 
indicator and may look into the future. 

EXAMPLE troughbars(close,5,1) 

SEE ALSO 
References: 


The TroughBars function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• Advanced Trend Lines with S & R 

• Constant Trendline Plot 

• Fibonacci Internal and External Retracements 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gartley 222 Pattern Indicator 

• Harmonic Patterns 

• Head & Shoulders Pattern 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• Modified Head & Shoulder Pattern 

• Pattern Recognition Exploration 

• Pivot Point with S/R Trendlines 

• QP2 Float Analysis 

• RSI Trendlines and Wedges 

• Stochastics Trendlines 

• The Fibonaccian behavior 

• Tom DeMark Trend Lines 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Full Stats 

• Zig-Hi Zap-Lo 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

More information: 

Updated on-line reference 


TroughBars - bars since trough 
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TSF 

- time series forecast 


Statistical functions 

(AFL 2.2) 


SYNTAX TSF(ARRAY, periods) 

RETURNS ARRAY 

FUNCTION Calculates time series forecast Indicator (similar to LInearReg but differs by 
the value of lln reg slope) 

The function accepts periods parameter that can be constant as well as time-variant (array). 

EXAMPLE Plot( Close, "Price", colorBlue, styleCandle ); 

Plot( TSF(close,5), "Time Series Forecast", colorRed ); 

SEE ALSO 
Comments: 


Nigei Rowe 

TSF Is exactly the estimate of LInearReg for the NEXT DAY. 

2003-04-30 

(It Is calculated as LInearReg PLUS LInRegSlope * 1 (bar)) 

06:03:00 



Plot(LlnearReg(Close, 10 )H-LlnRegSlope(Close, 10), "Forecast for tommorrow". 


colorRed); 


Plot(TSF(Close, 10 ), "Forecast for tommorrow 2", colorBlue ); 


References: 


The TSF function Is used In the following formulas In AFL on-line library: 

• Advanced MA system 
• DEBAJ 

• Moving Trend Bands (MTB) 

More information: 

Updated on-line reference 


TSF - time series forecast 
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Ultimate indicators 

- ultimate oscillator 


SYNTAX 

Ultimate( fast = 7, med = 14, slow = 28 ) 

RETURNS 

ARRAY 

FUNCTION 

Calculates the Ultimate Oscillator indicator using the three cycle lengths supplied as 
parameters. Note that each of the three parameters must be greater than the preceding 
parameter. 

EXAMPLE 

The formula "ultimate( 7, 14, 21 )" returns the default Ultimate Oscillator. 

SEE ALSO 


References: 



The Ultimate function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Adaptave Zones 0/B & 0/S Osciiiator 

• Uitimate pius 

• Varexiist 

More information: 

Updated on-line reference 


Ultimate - ultimate oscillator 
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Uncissues 
- unchanged issues 


Composites 

(AFL 1.2) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


UncIssuesO 

ARRAY 

Returns the number of unchanged issues for a given market (the one that currentiy anaiysed 
stock beiongs to) 

uncissuesO 


The Uncissues function is used in the foilowing formuias in AFL on-line library: 

More information: 


Updated on-line reference 


Uncissues - unchanged issues 
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UncVolume 

- unchaged issues volume 


Composites 

(AFL 1.2) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


UncVolumeO 

ARRAY 

Returns the volume of unchanged issues for a given market (the one that currently analysed 
stock belongs to) 

uncvolumeO 


The UncVolume function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


UncVolume - unchaged issues volume 
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ValueWhen 

- get value of the array when condition met 


Trading system toolbox 

(AFL 1.1) 


SYNTAX ValueWhen(EXPRESSION, ARRAY, n = 1) 
RETURNS ARRAY 


FUNCTION Returns the value of the ARRAY when the EXPRESSION was true on the n -th most recent 
occurrence. Note: this function allows also 0 and negative values for n - this enables 
referencing future 

EXAMPLE valuewhen( cross( close, ma(close,5)) ,macd(), 1) 

SEE ALSO 
References: 


The ValueWhen function Is used In the following formulas In AFL on-line library: 

• Alternative ZIG function 

• Alternative ZIG type function, multi TF 

• Andrews PltchforkV3.3 

• AR_Predlctlon.afl 

• Auto-Optimizatlon Framework 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• Automatic Trend-line 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• babaloo chapora 

• Baseline Relative Performance Watchllst charts V2 

• Basket Trading System T101 

• BEANS-Summary of Holdings 

• Bollinger band normalization 

• Bullish Percent Index 2004 

• Candle Stick Analysis 

• Candle Stick Demo 

• CCI(20) Divergence Indicator 

• Chandelier Exit 

• Chandelier Exit 

• Channel/S&R and trendlines 

• Chart Zoom 

• Cole 

• Colorfull Price 

• Congestions detection 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Date_To_Num(), Tlme_To_Num() 

• Divergence Indicator 

• Divergences 


ValueWhen - get value of the array when condition met 
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• Double top detection 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Fib Fan Based on ZZ 

• Fibonacci Internal and External Retracements 

• FirstBarIndexO, LastBarlndex() 

• Fund Screener 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gann HiLo Indicator and System 

• Gann Swing Chart 

• Gann Swing chart v41212 

• Gann Swing Charts in 3 modes with text 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Head & Shoulders Pattern 

• HH-LL-PriceBar 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• Inverted Plotted Volume Overlay Indicator 

• JEEVAN'S SRI CHAKRA 

• Last Five Trades Result Dashboard - AFL code 

• MACD commentary 

• Market Profile 

• MFE and MAE and plot trades as indicator 

• mitalpradip 

• Modified Head & Shoulder Pattern 

• Monthly bar chart 

• MS Darvas Box with Exploration 

• Now Send Push Notifications From Amibroker 

• Pattern Recognition Exploration 

• Peterson 

• PF Chart - Close - April 2004 

• Pivot Finder 

• Prashanth 

• Pullback System No. 1 

• Rainbow Oscillator 

• Relative Strength Multichart of up to 10 tickers 

• RSI of Weekly Price Array 

• RSI Trendlines and Wedges 

• Schiff Lines 

• shailu lunia 

• Steve Woods' Cum. Vol. Float + Cum. Vol. Channels 

• Steve Woods' Cumulative Vol. Percentage Indicator 

• Stochastic Divergence, negative 

• Stochastic Divergence, positive 

• Stochastic Divergences, PDI, NDI 

• Stochastic of Weekly Price Array 

• Stochastics Trendlines 

• Super Trend Indicator 

• Support and Resistance 

• Support Resistance levels 

• TD sequential 


ValueWhen - get value of the array when condition met 
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• TD Sequential 

• The Fibonaccian behavior 

• Time Frame Weekly Bars 

• Trend Detection 

• Trend exploration with multiple timeframes 

• Trend Exploration: Slope Moving Average 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• Using From and To dates from Auto Analysis in Code 

• Visible Min and Max Value Demo 

• Visualization of stoploses and profit in chart 

• Volatility Quality Index 

• VWAP - Volume Weighted Average Price 

• Weekly chart 

• Weekly Trend in Daily Graph 

• William's Alligator System II 

• Williams Alligator system 

• Zig Zag Indicator with Valid Entry and Exit Points 

More information: 

Updated on-line reference 


ValueWhen- get value of the array when condition met 
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VarGet 

- gets the value of dynamic variable 


Miscellaneous functions 

(AFL 2.60) 


SYNTAX VarGet( "varname") 

RETURNS ARRAY or NUMBER 

FUNCTION Gets the value of dynamic variable. 

Returns the NUMBER or ARRAY depending on type of underlying variable. 


Dynamic variables are variables that are named dynamically, typically by creating a variable 
name from a static part and a variable part. For example, the following example dynamically 
constructs the variable name from a variable prefix and a static suffix. Dynamic variables are 
always global. 

EXAMPLE for ( i = 1; i < 10; i++ ) 

{ 

Plot ( VarGet ( "C"+i ), "C"+i, colorRed ); 

} 

SEE ALSO VarSetO function , VarGetText() function , VarSetText() function 

References: 


The VarGet function is used in the following formulas in AFL on-line library: 

• AFL Timing functions 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Basket Trading System T101 

• Button trading using AB auto trading interface 

• Candle Identification 

• Continuous Contract Rollover 

• Cycle Period 

• Detailed Equity Curve 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Heatmap VI 

• Herman 

• interactively test discretionary trading 

• Intraday Average Volume 

• Intraday Volume EMA 

• Manual Bracket Order Trader 

• Non-repaitning Zigzag line 

• Now Send Push Notifications From Amibroker 

• Ranking Ticker WatchList 

• Rebalancing Backtest avoiding leverage 

• suresh 

• TWS auto-export Executions-file parser 

• Visi-Trade 


VarGet - gets the value of dynamic variable 
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• Woodie's CCI Panel Full Stats 
More information: 

Updated on-line reference 


VarGet- gets the value of dynamic variable 
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VarGetText 

- gets the text value of dynamic variable 


Miscellaneous functions 

(AFL 2.80) 


SYNTAX VarGetText( "varname") 

RETURNS STRING 

FUNCTION Gets the text (string) value of dynamic variable. 

Similar to VarGet but always returns always string values (if underlying variable has different 
type it is converted to string) Allows for example appending to text variable no matter if it is 
defined earlier or not as shown in the example below 


Dynamic variables are variables that are named dynamically, typically by creating a variable 
name from a static part and a variable part. For example, the following example dynamically 
constructs the variable name from a variable prefix and a static suffix. Dynamic variables are 
always global. 

EXAMPLE Title = VarGetText ( "Title" ) + "something"; 

// above will work correctly regardless of whenever title was 
defined earlier or not 

SEE ALSO VarGetQ function , VarSet() function 

References: 


The VarGetText function is used in the following formulas in AFL on-line library: 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• Automatic Linear Trend Channel 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• BEANS-Summary of Floldings 

• Button trading using AB auto trading interface 

• Calculate composites for tickers in list files 

• Continuous Contract Rollover 

• DateNumDateStr 

• Fleatmap VI 

• Manual Bracket Order Trader 

• Ranking and sorting stocks 

• suresh 

• TWS auto-export Executions-file parser 

• Visi-Trade 

• Woodie's CCI Panel Full Stats 


More information: 

Updated on-line reference 


VarGetText - gets the text value of dynamic variable 
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VarSet 

- sets the value of dynamic variable 


Miscellaneous functions 

(AFL 2.60) 


SYNTAX VarSet( "varname", value) 

RETURNS NUMBER 

FUNCTION Sets the value of dynamic variable. Returns 1 on success, 0 on failure. 


Dynamic variables are variables that are named dynamically, typically by creating a variable 
name from a static part and a variable part. The following example dynamically constructs 
the variable name from a variable prefix and a static suffix. Dynamic variables are always 
global. 

EXAMPLE f or ( i = 1 ; i < 10; i++ ) 


VarSet ( "C 
} 

// creates 
), Ref( C, 


"+i, Ref( C, -i ) 


variables Cl, C2, 
-2 ), ..Ref( 


// respectively 


C3, C4, CIO equal to Ref( 

C, -10 ) 


C, 


-1 


SEE ALSO VarGetQ function , VarGetText() function , VarSetText() function 

References: 


The VarSet function is used in the following formulas in AFL on-line library: 

• 2 Timeframes Candlestick Bar Chart 

• AFL Timing functions 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Basket Trading System T101 

• Button trading using AB auto trading interface 

• Candle Identification 

• Continuous Contract Rollover 

• Cycle Period 

• Detailed Equity Curve 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• Heatmap VI 

• Herman 

• interactively test discretionary trading 

• Intraday Average Volume 

• Intraday Volume EMA 

• Manual Bracket Order Trader 

• Non-repaitning Zigzag line 

• Now Send Push Notifications From Amibroker 

• Ranking and sorting stocks 


VarSet - sets the value of dynamic variable 
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• Ranking Ticker WatchList 

• Rebalancing Backtest avoiding leverage 

• Stress with SuperSmoother 

• suresh 

• TWS auto-export Executions-file parser 

• Visi-Trade 

• Woodie's CCI Panel Full Stats 
More information: 

Updated on-line reference 


VarSet- sets the value of dynamic variable 
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VarSetText 

- sets dynamic variable of string type 


Miscellaneous functions 

(AFL 2.80) 


SYNTAX VarSetText( "varname", "valuetext" ) 

RETURNS STRING 

FUNCTION Sets the text (string) value of dynamic variable. 

Similar to VarSet but allows to assign string (text) instead of number/array. 


Dynamic variables are variables that are named dynamically, typically by creating a variable 
name from a static part and a variable part. For example, the following example dynamically 
constructs the variable name from a variable prefix and a static suffix. Dynamic variables are 
always global. 


EXAMPLE 

SEE ALSO VarGetTextO function , VarGet() function , VarSet() function 

References: 


The VarSetText function is used in the following formulas in AFL on-line library: 

• AFL_Glossary_Converter 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Button trading using AB auto trading interface 

• Calculate composites for tickers in list files 

• Continuous Contract Rollover 

• DateNumDateStr 

• Fleatmap VI 

• Manual Bracket Order Trader 

• Ranking and sorting stocks 

• suresh 

• TWS auto-export Executions-file parser 

• Visi-Trade 

• Woodie's CCI Panel Full Stats 


More information: 

Updated on-line reference 


VarSetText - sets dynamic variable of string type 
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Version 

- get version info 


Miscellaneous functions 

(AFL 1.9) 


SYNTAX \/ers\on{minrequired = 0) 

RETURNS NUMBER 


FUNCTION Returns the AmiBroker version number as fioat ( 3.90 for exampie ). Additionaiiy when you 
specify Version( 4.0 ) AmiBroker wiii issue an error message when running the formuia on 
AB eariier than 4.0 :) 

EXAMPLE version( 3.90 ); 

SEE ALSO 
References: 


The Version function is used in the foiiowing formuias in AFL on-iine iibrary: 

• 2 Timeframes Candiestick Bar Chart 

• 3TF Candiestick Bar Chart 

• Automatic Trendiines using muitipie timeframes 

• Bad Tick Trim on 5 sec database 

• Continuous Contract Roilover 

• Gann Swing Charts in 3 modes with text 

• GFX ToolTip 

• JEEVAN'SSRI CHAKRA 

• P&F Chart - High/Low prices Sept2003 

• PF Chart - Close - April 2004 

• RSI + Avgs 

• RSI indicator with Upper & Lower Zone Bars 

• Visi-Trade 

• WILSON RELATIVE PRICE CHANNEL 

• Wolfe Wave Patterns 


More information: 

Updated on-line reference 


Version - get version info 
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Wilders Moving averages, summation 

- Wilder’s smoothing ^ 


SYNTAX Wiiders( ARRAY, periods ) 

RETURNS ARRAY 

FUNCTION Calculates Wilder's average of the ARRAY using periods averaging range 

EXAMPLE wllders( close, 10 ); 

SEE ALSO 
References: 


The Wiiders function Is used In the following formulas In AFL on-line library: 

• AC-i- acceleration 

• Adaptave Zones 0/B & 0/S Oscillator 

• Advanced MA system 

• Analytic RSI formula 

• AOh- Momentum Indicator 

• Average Price Crossover 

• babaloo chapora 

• Bollinger Fibonacci Bands 

• DEBAJ 

• DMI Spread Index 

• Fund Screener 

• garythompson 

• garythompson 

• Raw ADX 

• RSI of Weekly Price Array 

• The Mean RSIt 

• The Mean RSIt (variations) 

• Twiggs Money Flow 

• Twiggs money flow weekly 

• Volume Occllator 

• Volume Oscillator 

• William's Alligator System II 

• Williams Alligator system 

More information: 


Updated on-line reference 


Wilders - Wilder's smoothing 
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WMA 

- weighted moving average 


Moving averages, summation 

(AFL 2.0) 


SYNTAX 

RETURNS 

FUNCTiON 

EXAMPLE 

SEE ALSO 
References: 


wma( ARRAY, periods) 

ARRAY 

Calculates weighted average. 5 day weighted average gives weight of 5 to the most recent 
quote, 4 to the previous quote, downto 1 for the 5-bar back quote. The function accepts 
time-variable periods. 

WMA( Close, 5) 

MA(), EMA(), WMA(), DEMAQ 


The WMA function Is used In the following formulas In AFL on-line library: 

• Adverse Move Ratio 

• Automatic Linear Trend Channel 

• Automatic Linear Trend Channel 2 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Price Crossover 

• babaloo chapora 

• Bman's HaDIffCO 

• Chande's Trend Score 

• Chandelier Exit or Advanced Trailing Stop 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• DEBAJ 

• Dominant Cycle Phase 

• Gabriel Linear Regression Angle Indicator 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• Hull Moving Average 

• John Ehler 

• Multicycle 1.0 

• Neural Network Powered Smooth/PredIctIve RSI V2 

• Parametric Chande Trendscore 

• Relative strength comparison with moving average 

• Signal to Noise 

• Stochastic RSI 

• Volume Occllator 


More information: 

Updated on-line reference 


WMA - weighted moving average 


1143 



AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 

Writelf Exploration / Indicators 

- commentary conditional text output 


SYNTAX Writelf( EXPRESSION, "TRUE TEXT", "FALSE TEXT" ) 
RETURNS STRING 


FUNCTION If EXPRESSION evaluates to "true", then the TRUE TEXT string is dispiayed within the 

commentary. If EXPRESSION evaluates to "false", then the FALSE TEXT string is displayed. 

EXAMPLE writeif( c > mov(c,200,s), "The close is above the 200-period moving average.","The close is 
below the 200-period moving average.") 


SEE ALSO 
Comments: 


Tomasz Janeczko 

Writelf in fact does not "write" anything. The name is misleading but it is left 

tj -at- 

for easy translation of MS formulas to AmiBroker. 

amibroker.com 

Writelf is just "TextllF" it RETURNS string value depending on condition. 

2004-06-12 

05:56:01 

In commentary window, statements evaluating to STRINGS on global level 
are displayed in the output window. However if you do the same inside the 

FUNCTION 

it is no longer in global level (it is on LOCAL, FUNCTION level). 

To display actual string in this case use PRINTF function: 
http://www.amibroker.com/f7printf 

function comment(indicator) 

{ 

printf( "\nComment...\n"); 


printf( Writelf(1, "TrueText", "FalseText")); 
printf( WriteVal(indicator) h- "\n"); 

} 

Tomasz Janeczko 

Please note that Writelf returns just single string representing current SelectedValue 
of the EXPRESSION 

2005-08-10 

06:37:55 



References: 


The Writelf function is used in the following formulas in AFL on-line library: 

• 3 Price Break 

• Adaptave Zones 0/B & 0/S Oscillator 

• AR_Prediction.afl 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 


Writelf - commentary conditional text output 
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• AutoTrader Basic Flow - updated Nov 18, 2008 

• BMTRIX Intermediate Term Market Trend Indicator 

• Candlestick Comentary-Help needed 

• Candlestick Commentary 

• Candlestick Commentary Modified 

• Candlestick Commentary-modified 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI(20) Divergence Indicator 

• Color Display.afl 

• Commodity Channel Index 

• Coppock Trade Signal on Price Chart 

• COT REPORT 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Double top detection 

• ekeko price chart 

• Elder Impulse Indicator V2 

• Fre 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• IBD relative strength database Viewer 

• ICHIMOKU SIGNAL TRADER 

• Improved NH-NH scan / indicator 

• Intraday Fibonacii Trend Break System 

• Intraday Trend Break System 

• JEEVAN'S SRI CHAKRA 

• MA Difference 20 Period 

• MACD commentary 

• Main price chart with Rainbow & SAR 

• Market Facilitation Index VS Volume 

• mitalpradip 

• MS Darvas Box with Exploration 

• NRx Exploration 

• Performance Check 

• PF Chart - Close - April 2004 

• Polarized Fractal Efficiency 

• prakash 

• R-Squared 

• Relative Strength Index 

• Relative Strength Multichart of up to 10 tickers 

• ROC of MACD Weekly 

• RSI of Weekly Price Array 

• Scan New High and New Low 

• Square of Nine Roadmap Charts 

• STD_STK Multi 

• Stochastics Trendlines 

• StochD_StochK Single.afl 

• Stress with SuperSmoother 

• Sun&Cloud 

• Super Trend Indicator 

• TD Sequential 


Writelf - commentary conditional text output 
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• Time Left in Bar 

• Time Left to Current Bar 

• Trend Anaiysis_Comentary 

• Trend expioration with muitipie timeframes 

• Trend Expioration: Slope Moving Average 

• Triangular Moving Average 

• Triangular Moving Average new 

• Vertical Horizontal Filter (VHP) 

• Volume Occilator 

• Weekly Trend in Daily Graph 

• William's Alligator System II 

• Williams Alligator system 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Price Panel With Woodie's Pivots 

• Zig Zag Indicator with Valid Entry and Exit Points 

• ZigZag Retracements 

More information: 

Updated on-line reference 


Writelf- commentary conditional text output 
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WriteVal Exploration / Indicators 

- converts number to string 


SYNTAX WriteVal( NUMBER, format = 1.3, separator=True, roundAndPad = False ) 

WriteVal( ARRAY, format = 1.3, separator=Jtue, roundAndPad = False ) 

RETURNS STRING 

FUNCTION THIS FUNCTION IS OBSOLETE. Use functionally identical NumToStrQ instead. 

It is used to convert numeric value of NUMBER or ARRAY to string. It does NOT write 
anything, it simply returns a string that can be used in other operations or as a text column in 
exploration or displayed using printf(). 

The second parameter - format - allows you to control output formatting (decimal places and 
leading spaces). The integer part of the number controls minimum number of characters 
used to display the number (if you specify high number the output will be space-padded). 

The fractional part defines how many decimal places to display, for example 1.0 - will give 
you a number without fractional part at all, and 1.2 - will give two digits past the decimal point 

There is also a special format constant formatDateTime that allows to convert date/time 
returned by DateTime() function formatted according to Windows regional settings. 

Third parameter separator (true by default) controls if thousand separator is added or not. 
Thousands separator is definable in Tools->Preferences->Misc. 

Fourth parameter roundAndPad controls whenever function rounds output beyond 7th 
significant digit (and pads the rest with zeros). By default rounding is OFF now because it 
was off in 5.90 and earlier and rounding introduced in 5.91 could confuse old time users 


Note: NumToStr is a synonym for WriteVal function and NumToStr is preferred in new 
coding. 

EXAMPLE printf( WriteVal( Close, 1.3, True )); 

For more examples see NumToStr function 

SEE ALSO WRITEIFO function , DATETIME() function , NumToStr() function 

Comments: 


Tomasz Janeczko 

tj -at- 

amibroker.com 

2004-06-12 

05:53:06 

WriteVal always returns *one* value of the array 
(not arrays of values). In almost all cases this is LastValue 
of the array but in indicators it is "selected value" - 
the one that is selected by the vertical line. 

Tomasz Janeczko 

tj -at- 

amibroker.com 

2004-06-12 

05:54:45 

The name WriteVal() is here because people coming from Metastock wanted easy 
translation from MS that has WriteVal function too. 

Better name for it is Num2Str. 


WriteVal - converts number to string 
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References: 

The WriteVal function is used in the foiiowing formuias in AFL on-iine iibrary: 

• AccuT rack 

• Advisory NRx price chart dispiay. 

• ADX Indicator - Colored 

• AFL Example 

• AFL Example - Enhanced 

• AFL_Glossary_1 

• Alert Output As Quick Rewiev 

• Alpha and Beta and R_Squared Indicator 

• Aroon Indicators 

• AR_Prediction.afl 

• babaloo chapora 

• Baseline Relative Performance Watchlist charts V2 

• BB squeeze 

• Bollinger - Keltner Bands 

• Bull Fear / Bear Fear 

• Bullish Percent Index 2 files combined 

• Bullish Percent Index 2004 

• Candlestick Comentary-Help needed 

• CCI(20) Divergence Indicator 

• Chande Momentum Oscillator 

• Cole 

• Color Coded Short Term Reversal Signals 

• colored CCI 

• COMBO 

• Commodity Channel Index 

• Coppock Trade Signal on Price Chart 

• Count Tickers in Watchlist 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• De Mark's Range Projection 

• Dinapoli Guru Commentary 

• DiNapolis 3x Displaced Moving Averages 

• Elder safe Zone Long -i- short 

• Elder's SafeZone Stop 

• ElderSafeZoneStopLong 

• ElderSafeZoneStopShort 

• Expiry day/days - Last thursday of month 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Fre 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Futures - Dollar Move Indicator 

• Futures - Dollar Move Today Indicator 

• Gann level plotter 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 


WriteVal- converts number to string 
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• hassan 

• ICHIMOKU SIGNAL TRADER 

• Improved NH-NH scan / indicator 

• Intraday Fibonacii Trend Break System 

• IntraDay Open Marker 

• Intraday Trend Break System 

• JEEVAN'S SRI CHAKRA 

• Larry William's Volatility Channels 

• Last Five Trades Result Dashboard - AFL code 

• MA Difference 20 Period 

• MACD commentary 

• MACD Histogram - Change in Direction 

• MACD indicator display 

• Main price chart with Rainbow & SAR 

• Meu Sistema de Trading - versao 1.0 

• MFE and MAE and plot trades as indicator 

• mitalpradip 

• Monthly bar chart 

• Monthly Coppock Guide 

• MS Darvas Box with Exploration 

• Multiple sinus noised 

• N-period candlesticks (time compression) 

• Option Calls, Puts and days till third friday. 

• P&F chart with range box sizes 

• Parabolic SAR in JScript 

• Parabolic SAR in VBScript 

• Performance Check 

• Peterson 

• PF Chart - Close - April 2004 

• Pivot End Of Day Trading System 

• Pivot Finder 

• Pivot Point and Support and Resistance Points 

• plot tomorrows pivots on an intraday database 

• Point & figure Chart India Securities 

• Position Sizing and Risk Price Graph 

• Position Sizing and Risk Price Graph - 2 

• prakash 

• Prashanth 

• Probability Calculator 

• QP2 Float Analysis 

• Rainbow Charts 

• Rainbow Oscillator 

• Rea Time Daily Price Levels 

• Relative Momentum Index (RMI) 

• Relative Strength Index 

• Relative Strength Multichart of up to 10 tickers 

• ROC of MACD Weekly 

• RSI of Weekly Price Array 

• RSIS 

• shailu lunia 

• Shares To Buy Price Graph 

• STD STK Multi 


WriteVal- converts number to string 
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• Steve Woods' Float Channel Lines 

• Stochastics Trendlines 

• StochD_StochK Single.afl 

• Super Trend Indicator 

• Support Resistance levels 

• TD Sequential 

• The D_osclllator 

• tomy_frenchy 

• Trend Analysls_Comentary 

• Triangular Moving Average 

• Triangular Moving Average new 

• Trigonometric Fit - TrIgFIt with AR for cos / sin 

• TRIX 

• Tushar Chande's Projected Range 

• Using From and To dates from Auto Analysis In Code 

• ValueChart 

• Volume Occllator 

• Volume Oscillator 

• Weinberg's The Range Indicator 

• William's Alligator System 11 

• Williams Alligator system 

• WILSON RELATIVE PRICE CHANNEL 

• ZIg-HI Zap-Lo 

More information: 

Updated on-line reference 


WriteVal- converts number to string 
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XYChartAddPoint 

- add point to exploration scatter (XY) chart 


Exploration / Indicators 

(AFL 3.60) 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


XYChartAddPoint( "chartname", "text", x, y, color, linecolor = colorDefault) 

NUMBER 

The function adds a data point with specified x,y co-ordinates, text description and point coior 
to the expioration (XY) scatter chart defined by "chartname" parameter. 

If chart with given name does not exists aiready it creates a scatter chart tab in the New 
Anaiysis Expioration output window. 

Returns 1 (true) on success (when point was added), or 0 (faise) on failure - for example 
when X or y arguments were Null 

More on XY charts in explorations can be read in the Tutorial: How to create your own 
exploration 

// XY chart coding example 

// This formula generates 2 X-Y scatter charts that display 
relationship between 

// final trade profit and MFE and MAE 

Buy = Cross ( MACD (), Signal ()); 

Sell = Cross ( Signal (), MACD () ); 

Short = False; 

Cover = False; 

Eg = Equity ( 1 ); // single-security equity this evaluates stops 
(if you use them) and removes extra signals 

Entry = Buy OR Short; 

EqAtEntry = ValueWhen ( Entry, Eq ); 

Profit = 100 * ( Eq - EqAtEntry ) / EqAtEntry; // percent profit 

// MAE and MFE below use CLOSING equity, MAE and MFE in the report 
use high/low price 

MAE = 100 * ( LowestSince ( Entry, Eq ) - EqAtEntry ) / EqAtEntry; // 

percent MAE 

MFE = 100 * ( HighestSince ( Entry, Eq ) - EqAtEntry ) / EqAtEntry; 

// percent MAE 

bi = BarIndexO; 

Len = bi - ValueWhen ( Entry, bi ); 

EntryPrice = ValueWhen ( Entry, BuyPrice ); 

// if you prefer MAE/MFE using high/low price 
// uncomment the lines below (long only Version) 

MAE = 100 * ( LowestSince ( Entry, Low ) - EntryPrice ) / EntryPrice 


SYNTAX 

RETURNS 

FUNCTION 


EXAMPLE 


XYChartAddPoint - add point to exploration scatter (XY) chart 
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; // percent MAE using low 

MFE = 100 * ( HighestSince ( Entry, High ) - EntryPrice ) / 

EntryPrice ; // percent MAE using high 

Exit = Sell OR Cover; 

dt = DateTime (); 

Clr = ColorHSB ( Status ("stocknum" ), 255, 255 ); 
for ( bar = 0; bar < BarCount; bar++ ) 


if ( Exit[ bar ] ) 

{ 

// item text consists of two parts 
// first part (before t) is a item name displayed 
immediatelly on XY chart 

// second part (after t) is a tooltip hint text that is 
displayed in the tooltip 

// when you hover on given item 
// here we will only use hint text 

HintText = "t" + Name()+"@"+ DateTimeToStr ( dt[ bar ] ) ; 


Profit[ bar ],Clr ); 

XYChartAddPoi) 
Profit[ bar ], Clr ); 

XYChartAddPoi) 
bar ], Profit[ bar ], 

} 


Profit 

vs MAE", 

HintText, 

MAE [ 

bar ] , 

Profit 

vs MFE", 

HintText, 

MFE [ 

bar ] , 

Profit 

) ; 

vs trade 

length" , 

HintText, Len[ 

MAE ", 
MFE", 

"[MAE] ", 

"[MFE] ", 

"[Profit] 
"[Profit] 

" ) ; 

" ); 



XYChartSetAxis ( "Profit vs trade length", "[Length] 


[Profit]" ); 


Filter = Exit; 

AddColumn ( Eq, "Equity" ); 

AddColumn ( Profit, "Profit" ); 

AddColumn ( MAE, "MAE" ); 

AddColumn] MFE, "MFE" ); 

AddColumn] Len, "trade length" ); 

SEE ALSO XYChartSetAxisO function 

References: 

The XYChartAddPoint function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-iine reference 


XYChartAddPoint- add point to exploration scatter (XY) chart 
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XYChartSetAxis 

- set the names of X and Y axes in exploration scatter charts 


Exploration / Indicators 

(AFL 3.60) 


SYNTAX XYChartSetAxis( "chartname", "x-axis name", "y-axis name", style = 0 ) 
RETURNS NOTHING 

FUNCTION The function sets the name of X and Y axis for the Expioration scatter (XY) charts. 


Since version 6.0 it aiiows to define chart styie. Supported styies are styieLine, styieDots, 
styieHistogram, styieThick and combinations of those styies. 

EXAMPLE chartnaine="example" ; 


XYChartSetAxis (chartname, "[x]", "[sinx/x]", styieLine | styieDots 

); // bar style 

for ( X = -10; X < 10; x += 0.2 ) 

{ 

y = sin (x ) / x; 

XYChartAddPoint ( chartname, x, y, colorGreen, colorRed ); 

} 


XYChartAddPoint ( chartname, Null, Null ); // add a NULL point to 

begin new line 

for ( X = -10; X < 10; x += 0.2 ) 

{ 

y=sin(2*x) /x; 

XYChartAddPoint ( chartname, x, y, colorOrange, colorBlue ); 

} 

SEE ALSO XYChartAddPointO function 

References: 

The XYChartSetAxis function is used in the foliowing formulas in AFL on-line library: 

More information: 

Updated on-line reference 


XYChartSetAxis - set the names of X and Y axes in exploration scatter charts 
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Year 
- year 


SYNTAX YearO 

RETURNS ARRAY 

FUNCTION Returns the array with years (full four digits 1900-....) 

EXAMPLE writeval( year()); 

SEE ALSO 
References: 


The Year function is used in the following formulas in AFL on-line library: 

• Auto Trade Step by Step 

• Days to Third Friday 

• End Of Year Trading 

• Expiry day/days - Last thursday of month 

• Expiry Thursday for Indian markets 

• Export All Daily Data to TXT with MS import format 

• Export EOD or Intraday to .csv file 

• Export Intraday Data 

• Luna Phase 

• Lunar Phases - original 

• LunarPhase 

• Monthly bar chart 

• N-period candlesticks (time compression) 

• Next Date Format 

• Prashanth 

• Relative Strength Multichart of up to 10 tickers 

More information: 


Updated on-line reference 


Date/Time 

(AFL 1.4) 


Year - year 
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ZIG 

- zig-zag indicator 


Basic price pattern detection 

(AFL 1.1) 


SYNTAX zig(ARRAY, cftanfife) 
RETURNS ARRAY 


FUNCTiON Calculates the minimum % change ZIg Zag Indicator. Caveat: this function Is based on 
Zig-Zag Indicator and may look Into the future - this means that you can get unrealistic 
results when back testing trading system using this Indicator. This function Is provided rather 
for pattern and trend recognition formulas. 

EXAMPLE zlg(close,5) 

SEE ALSO 
References: 


The ZiG function Is used In the following formulas In AFL on-line library: 

• Pivots And Prices And Swing Volume 

• Andrews PltchforkV3.3 

• Bollinger band normalization 

• Divergence Indicator 

• Fib Fan Based on ZZ 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Heatmap VI 

• Indicator Explorer (ZIgZag) 

• Multiple Ribbon Demo 

• Ord Volume 

• QP2 Float Analysis 

• Schiff Lines 

• The FIbonacclan behavior 

• Volatility Quality Index 

• ZIg Explorer 

• ZIg Zag Indicator with Valid Entry and Exit Points 

• ZIg-HI Zap-Lo 

• ZIgZag HI Lo Barcount 

• ZIgZag Retracements 

More information: 

Updated on-line reference 


ZIG - zig-zag indicator 
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_DEFAULT_NAME 
- retrive default name of the plot 


Exploration / Indicators 

(AFL 2.70) 


SYNTAX _DEFAULT_NAME() 
RETURNS STRING 


FUNCTION This function returns the defauit name of piot in the drag-drop section. The defauit name 

consists of section name and comma separated iist of vaiues of numeric parameters defined 
in given section. 

EXAMPLE _SECTION_BEGIN ( "MAI " ); 

P = ParamField ( "Price field"); 

Periods = Param ( "Periods" , 15, 2, 200, 1, 10 ); 

Plot ( MA( P, Periods ), _DEFAULT_NAME(), ParamColor ( "Color", 
colorCycle ), ParamStyle ( "Style" ) ); 

_SECTION_END(); 


_DEFAULT_NAME wili evaiuate to "MA1 (Close,15)" string. 

SEE ALSO _SECTION_BEGIN() function , _SECTION_NAME() function , _SECTION_END() function 

References: 


The _DEFAULT_NAME function is used in the following formulas in AFL on-line library: 

• Advanced MA system 

• AFL Example 

• AFL Example - Enhanced 

• AFL to Python COM Link 

• AO-nMomentum 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Price Crossover 

• babaloo chapora 

• Button trading using AB auto trading interface 

• Dave Landry PullBack Scan 
• DEBAJ 

• DiNapolis 3x Displaced Moving Averages 

• DPO with shading 

• Elder Triple Screen Trading System 

• Elder's Market Thermometer 

• Elliott Wave Oscillator 

• Fibonacci Moving averages 

• Gann level plotter 

• Heikin-Ashi(Koma-Ashi) with Moving Average 

• Herman 

• IB Backfiller 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 


DEFAULT NAME - retrive default name of the plot 
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• Intraday Trend Break System 

• Manual Bracket Order Trader 

• mitalpradip 

• Mndahoo ADX 

• Modified-DVI 

• Neural Network Powered Smooth/Predictive RSI V2 

• NoorDoodie 

• ParabXO 

• prakash 

• PVT Trend Decider 

• Random Walk Index 

• Rl - Auto Trading System 

• RSI indicator with Upper & Lower Zone Bars 

• RSI styleClipMinMax 

• shailu lunia 

• Simple Momentum 

• Triangular Moving Average new 

• Twiggs Money Flow 

• Ultimate plus 

• UltraEdit editor highlight wordfile 

• Vikram's Floor Pivot Intraday System 

• ZigZag filter rewrited from scratch in AFL 

• ZigZag Hi Lo Barcount 

More information: 

Updated on-line reference 


DEFAULT NAME- retrive default name of the plot 
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_DT 

- convert string to datetime 


Date/Time 

(AFL 3.40) 


SYNTAX _DT("date string"); 

RETURNS NUMBER 

FUNCTION Converts string representing date/time vaiue to the corresponding DateTime number (that 
can be iater compared to output of DateTime() function for exampie). 


This function is synonym / shortcut for StrToDateTime function. 

EXAMPLE 

SEE ALSO StrToDateTimeO function 

References: 


The _DT function is used in the foiiowing formuias in AFL on-iine iibrary: 

More information: 

Updated on-iine reference 


DT - convert string to datetime 
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_N 

- no text output 


Exploration / Indicators 

(AFL 2.1) 


SYNTAX 

RETURNS 

FUNCTION 

EXAMPLE 

SEE ALSO 
References: 


_N( string) 

nothing 

Protects from printing string to the commentary output window 

_N( ticker = name()); // thanks to _N function ticker symboi is not printed 

ENABLETEXTOUTPUTO function 


The _N function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Pivots And Prices And Swing Voiume 

• 'R' Channei 

• 10-20 indicator 

• 2 Timeframes Candiestick Bar Chart 

• 30 Week Fii indicator - Dispiay 

• 3TF Candiestick Bar Chart 

• 4% Modei - Determine Stock Market Direction 

• 52 Week New Fiigh-New Low index 

• AccuT rack 

• Adaptive Laguerre Fiiter, from John Ehiers 

• Advanced MA system 

• Advanced Trend Lines with S & R 

• Advisory NRx price chart dispiay. 

• ADXbuy 

• AFL Exampie 

• AFL Exampie - Enhanced 

• AFL to Python COM Link 

• AFLGiossaryl 

• AFL_Giossary_Converter 

• Aiert Output As Ouick Rewiev 

• ALJEHANi 

• Aipha and Beta and R_Squared indicator 

• Aiternative ZiG function 

• Aiternative ZiG type function, muiti TF 

• Andrews Pitchfork 

• Andrews PitchforkV3.3 

• Animated BackGround 

• Animated BackGround 1.1 

• AOn-Momentum 

• Appei's ROC or The Tripie Momentum Timing Modei 

• Aroon indicators 

• Aroon The Advisor 

• AR_Prediction.afi 

• ATR Study 

• Auto Trade Step by Step 

• Auto Trader Basic Fiow 


N - no text output 
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• Auto-Optimization Framework 

• Automatic Linear Trend Channei 

• Automatic Linear Trend Channei 2 

• Automatic trend channei 

• Automatic Trend-line 

• automatic trendlines using fractal patterns 

• Automatic Trendlines using multiple timeframes 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Dollar Price Volatility Exploration 

• Average Price Crossover 

• babaloo chapora 

• Bad Tick Trim on 5 sec database 

• Baseline Relative Performance Watchlist charts V2 

• Basket Trading System T101 

• BEANS-Summary of Floldings 

• Bid Vs Ask Dashboard 

• Binary to Decimal Converter 

• Black Scholes Option Pricing 

• Bman's FlaDiffCO 

• BMTRIX Intermediate Term Market Trend Indicator 

• Bollinger band normalization 

• Bollinger Band Width 

• Bottom Fisher Exploration 

• Bull Fear / Bear Fear 

• Bullish Percent Index 

• Bullish Percent Index 2 files combined 

• Bullish Percent Index 2004 

• Button trading using AB auto trading interface 

• Calculate composites for tickers in list files 

• CAMSLIM Cup and Handle Pattern AFL 

• Candle Identification 

• Candle Pattern Function 

• Candle Stick Analysis 

• Candle Stick Demo 

• candlestick chart for Volume/RSI/OBV 

• Candlestick Comentary-Help needed 

• Candlestick Commentary 

• Candlestick Commentary Modified 

• Candlestick Commentary-modified 

• CCI 14 DrBobStyle 

• CCI 50 DrBob Style 

• CCI(20) Divergence Indicator 

• Chandelier Exit 

• Chandelier Exit 

• changing period moving average 

• Channel/S&R and trendlines 

• Chart Zoom 

• CoinToss ver 1 

• Cole 

• Color Display.afl 


N - no text output 
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• Color Price Bar - Impulse System 

• Color Price Bars with MACD Histogram Changes 

• Colorfull Price 

• com-out 

• Commodity Selection Index (CSI) 

• Congestions detection 

• Connors TPS 

• Continuous Contract Rollover 

• Coppock Histogram 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• correlerror 

• COT REPORT 

• Count Tickers in Watchlist 

• crMathLib 

• CVR-severe filter 

• Cybernertic Hilbert Sine Wave 

• Cycle Highlighter 

• Cycle Highlighter (auto best-fit) 

• Cycle Period 

• Daily High Low in Advance 

• danningham penetration 

• DateNumDateStr 

• Date_To_Num(), Time_To_Num() 

• Dave Landry PullBack Scan 

• DEBAJ 

• Demand Index 

• Detailed Equity Curve 

• Digital indiactors 

• DiNapolis 3x Displaced Moving Averages 

• Divergence indicator 

• Divergences 

• DMI Spread Index 

• Dominant Cycle Phase 

• Double top detection 

• Dynamtic Momentum Index 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• ekeko price chart 

• EKEKO SAR-MF 

• Elder Impulse Indicator V2 

• Elder Ray - Bull Bear 

• Elder Ray Oscillator with MA 

• Elder safe Zone Long -i- short 

• Elder Triple Screen Trading System 

• Elder's Market Thermometer 

• Elliott Wave Oscillator 

• EMA Crossover 

• End Of Year Trading 

• Envelope System 

• Evaluating Candle Patterns in a trading system 

• Expiry day/days - Last thursday of month 


N - no text output 
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• Export All Dally Data to TXT with MS Import format 

• Export EOD or Intraday to .csv file 

• Export Intraday Data 

• Fast Refreshed KAGI Swing Charts (Price Swing) 

• FastStochK FullStochK-D 

• Fib Fan Based on ZZ 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• FIrstBarIndexO, LastBarlndex() 

• Fisher Oscillator 

• Follow the Leader 

• Force Index 

• Fre 

• Fund Screener 

• Future MA Projection 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gabriel Linear Regression Angle Indicator 

• Gann HILo Indicator and System 

• Gann level plotter 

• Gann Swing Chart 

• Gann Swing chart v41212 

• Gann Swing Charts In 3 modes with text 

• GFX ToolTip 

• Gordon Rose 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• half-automated Trading System 

• Harmonic Patterns 

• Head & Shoulders Pattern 

• Heatmap V1 

• Helkin AshI Candles 

• Helkin AshI Delta 

• Helkln-Ashl(Koma-Ashl) with Moving Average 

• HeInkIn-AshI 

• Herman 

• HH-LL-PrIceBar 

• Hilbert Sine Wave 

• Hilbert Sine Wave Support & Resistance 

• Hilbert Sine Wave with Hull Moving Average 

• Hilbert Study 

• Historical Volatility Index 

• Historical Volotlllty Scan - 6/100 

• Historical Volotlllty Scan - 50 Day 

• HLspread 

• Hull Rate of Return Indicator 

• IB Backfiller 

• IBD relative strength database ranker 

• IBD relative strength database Viewer 

• ICHIMOKU SIGNAL TRADER 

• IchImokuBrIanVIoreIRO 


N - no text output 
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• Improved NH-NH scan / indicator 

• In Watch List 

• Index of 30 Wk Highs Vs Lows 

• Indicator Expiorer (ZigZag) 

• Inside Bar 

• Inside Bar 

• Inter-market Yield Linear Regression Divergence 

• interactively test discretionary trading 

• Intraday Average Volume 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 

• Intraday Strength 

• Intraday Trend Break System 

• Inverted Plotted Volume Overlay Indicator 

• JEEVAN'S SRI CHAKRA 

• John Ehler 

• Kelly criterion 

• Kiss and Touch with the Modified True Range 

• Last Five Trades Result Dashboard - AFL code 

• Luna Phase 

• LunarPhase 

• MACD commentary 

• MACD Histogram - Change in Direction 

• MACD indicator display 

• Manual Bracket Order Trader 

• Market Breadth Chart-In-Chart 

• Market Facilitation Index VS Volume 

• Market Profile 

• MFE and MAE and plot trades as indicator 

• mitalpradip 

• MOCS 

• Modified Head & Shoulder Pattern 

• Modified-DVI 

• Monthly bar chart 

• Moving Average "Crash" Test 

• MO_CrashZone 

• MS Darvas Box with Exploration 

• Multicycle 1.0 

• Multiple Ribbon Demo 

• Multiple sinus noised 

• NASDAO 100 Volume 

• Neural Network Powered Smooth/Predictive RSI V2 

• Nick 

• nifty 

• Non-repaitning Zigzag line 

• NoorDoodie 

• Now Send Push Notifications From Amibroker 

• NRx Exploration 

• nth (1 - 8 ) Order Polynomial Fit 

• OBV with Linear Regression 

• Option Calls, Puts and days till third friday. 

• Ord Volume 


N - no text output 
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• P&F Chart - High/Low prices Sept2003 

• P&F chart with range box sizes 

• Paraboiic SAR in VBScript 

• Parametric Chande Trendscore 

• Pattern - Rectangie Base Breakout on Fligh Vol 

• Pattern Recognition Exploration 

• Pattern_-_Rectangle_Base_Breakout_on_Fligh_Vol 2 

• Percentage Price Oscillator 

• Perceptron 

• Performance Check 

• Peterson 

• PF Chart - Close - April 2004 

• Pivot End Of Day Trading System 

• Pivot Finder 

• Pivots And Prices 

• Pivots for Intraday Forex Charts 

• Plot the Equity Curve without Backtesting? 

• plot tomorrows pivots on an intraday database 

• Plot visual stop / target ratio. 

• Point & figure Chart India Securities 

• Position Sizer vers2, stocks and CFDs 

• Positive Bars Percentage 

• prakash 

• Prashanth 

• Price Persistency 

• Probability Density & Gaussian Distribution 

• Projection Oscillator 

• Pullback System No. 1 

• PVT Trend Decider 

• qp2 industry charts as a panel in the stocks chart 

• R-Squared 

• Rainbow Oscillator 

• Random Walk Index 

• Ranking and sorting stocks 

• Ranking Ticker WatchList 

• Rebalancing Backtest avoiding leverage 

• Relative Strength 

• Relative Strength Index 

• Relative Strength Multichart of up to 10 tickers 

• Rene Rijnaars 

• Renko Chart 

• Reverse MFI Crossover 

• Rl - Auto Trading System 

• Robert Antony 

• RSI + Avgs 

• RSI Double-Bottom 

• RSI indicator with Upper & Lower Zone Bars 

• RSI of Weekly Price Array 

• RSI Trendlines and Wedges 

• RUTVOL timing signal with BB Scoring routine 

• Sainath Sidgiddi 

• SAR-ForNextBarStop 


N - no text output 
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• Scale Out: Futures 

• Scan New High and New Low 

• Schiff Lines 

• Sector Tracking 

• SectorRSI 

• shailu lunia 

• Signal to Noise 

• Simple Candle Exploration 

• Sine Wave Indicator 

• Smoothed Adaptive Momentum 

• Sony 

• Square of Nine Roadmap Charts 

• STD_STK Multi 

• Steve Woods' Cum. Vol. Float + Cum. Vol. Channels 

• Steve Woods' Cumulative Vol. Percentage Indicator 

• Stochastic %J - KDJ 

• Stochastic Divergence, negative 

• Stochastic Divergence, positive 

• Stochastic Divergences, PDI, NDI 

• Stochastic of Weekly Price Array 

• Stochastic Oscillator 

• Stochastics Trendlines 

• StochD_StochK Single.afl 

• Stops Implementation in AFS 

• Stops on percentages 

• Strength and Weakness 

• Stress with SuperSmoother 

• SUPER PIVOT POINTS 

• Super Trend Indicator 

• Support and Resistance 

• Support Resistance levels 

• suresh 

• TAZ Trading Method Exploration 

• TD Channel-1 

• TD Channel-2 

• TD Moving Average 2 

• TD Moving Average I 

• TD REI 

• TD sequential 

• TD Sequential 

• testing multiple system simulataneously 

• The D_oscillator 

• The Fibonaccian behavior 

• Three Day Balance Point 

• Three Line Break - TLB 

• Three Pole Butterworth 

• Time Frame Weekly Bars 

• Time Left in Bar 

• tomy_frenchy 

• Tracking Error 

• Tracking Error 

• Trend Analysis_Comentary 


N - no text output 
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• Trend Detection 

• Trend exploration with multiple timeframes 

• Trend Exploration: Count Number of New Highs 

• Trend Exploration: Slope Moving Average 

• Trend Following System 

• Trend Lines from 2 points 

• Trending Ribbon 

• TrendingRibbonArrowsADX 

• Triangle exploration using P&F Chart 

• Triangle Search Extended 

• Triangular Moving Average new 

• Trigonometric Fit - TrigFit with AR for cos / sin 

• TTM Squeeze 

• Twiggs Money Flow 

• Twiggs money flow weekly 

• TWS auto-export Executions-file parser 

• TWS trade plotter 

• Ultimate plus 

• UltraEdit editor highlight wordfile 

• Using From and To dates from Auto Analysis in Code 

• Vikram's Floor Pivot Intraday System 

• Visi-Trade 

• Visible Min and Max Value Demo 

• Visualization of stoploses and profit in chart 

• Volatility Quality Index 

• Volatility System 

• Volume - compared with Moving Avg (100%) 

• Volume Charts 

• Volume Occilator 

• VSTOP (2) 

• VSTOP (3) 

• VWAP - Volume Weighted Average Price 

• Weekly chart 

• Weekly Trend in Daily Graph 

• Weighted Index 

• William's Alligator System II 

• Williams Alligator system 

• WILSON RELATIVE PRICE CHANNEL 

• WLBuildProcess 

• Wolfe Wave Patterns 

• Woodie's CCI Panel Basic 

• Woodie's CCI Panel Full Stats 

• Woodie's Heikin-Ashi Panel 

• Woodie's Price Panel With Woodie's Pivots 

• Zig Zag 

• Zig Zag Indicator with Valid Entry and Exit Points 

• Zig-Hi Zap-Lo 

• ZigZag filter rewrited from scratch in AFL 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

• ZLEMA ATR Long Only Trading System 


N - no text output 


1166 



AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


More information: 

Updated on-line reference 


N- no text output 
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_PARAM_VALUES 
- retrieve param values string 


Exploration / Indicators 

(AFL 2.70) 


SYNTAX _PARAM_VALUES() 

RETURNS STRING 

FUNCTION _PARAM_VALUES retrieves the values of the parameters defined in current drag-drop 

section. It works the same as _DEFAULT_NAME except that no section name is included (so 
only the list of parameter values is returned). 

EXAMPLE 


SEE ALSO _DEFAULT_NAME() function 

References: 


The _PARAM_VALUES function is used in the following formulas in AFL on-line library: 

• Advanced MA system 

• ALJEHANI 

• babaloo chapora 

• Bman's HaDiffCO 

• bolingerbands 

• bonlinger bands 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• Elder Triple Screen Trading System 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 

• prakash 


More information: 


Updated on-line reference 


PARAM VALUES - retrieve param values string 
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- section begin marker 


SECTION BEGIN 


Exploration / Indicators 

(AFL 2.70) 


SYNTAX _SECTION_BEGIN( "section name" ) 


RETURNS NOTHING 


FUNCTION Marks beginning of the drag-drop section. 


IMPORTANT: "section name" must be a constant, iiterai string, enciosed in doubie quotation 
marks. You must NOT use variable here. 


EXAMPLE 

SEE ALSO 
References: 

The _SECTION_BEGIN function is used in the foiiowing formuias in AFL on-iine iibrary: 

• Pivots And Prices And Swing Voiume 

• 10-20 Indicator 

• 2 Timeframes Candiestick Bar Chart 

• 3TF Candiestick Bar Chart 

• Advanced MA system 

• Advanced Trend Lines with S & R 

• AFL Exampie 

• AFL to Python COM Link 

• AFL_Giossary_Converter 

• ALJEHANI 

• Animated BackGround 

• Animated BackGround 1.1 

• AOn-Momentum 

• Appei's ROC or The Tripie Momentum Timing Modei 

• Aroon The Advisor 

• Auto Trade Step by Step 

• Auto Trader Basic Fiow 

• Automatic Linear Trend Channei 2 

• Automatic trend channei 

• Automatic Trendiines using muitipie timeframes 

• AutoTrader Basic Fiow - updated Aprii 15, 2009 

• AutoTrader Basic Fiow - updated Nov 18, 2008 

• Average Price Crossover 

• babaioo chapora 

• Bad Tick Trim on 5 sec database 

• Basket Trading System T101 

• Bid Vs Ask Dashboard 

• Bman's HaDiffCO 

• Boiiinger Band Width 

• Button trading using AB auto trading interface 

• Candie Identification 

• Candie Stick Demo 

• Chandeiier Exit 


SECTION BEGIN - section begin marker 
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• Chandelier Exit 

• changing period moving average 

• Chart Zoom 

• CoinToss ver 1 

• Colorfull Price 

• com-out 

• Commodity Selection Index (CSI) 

• Continuous Contract Rollover 

• Coppock Histogram 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• Daily High Low in Advance 

• DateNumDateStr 

• Dave Landry PullBack Scan 

• DEBAJ 

• Digital indiactors 

• DiNapolis 3x Displaced Moving Averages 

• Dynamtic Momentum Index 

• Elder Impulse Indicator V2 

• Elder Ray - Bull Bear 

• Elder Ray Oscillator with MA 

• Elder safe Zone Long + short 

• Elder Triple Screen Trading System 

• Elder's Market Thermometer 

• Elliott Wave Oscillator 

• Expiry day/days - Last thursday of month 

• FastStochK FullStochK-D 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Force index 

• Fre 

• Future MA Projection 

• Future Plotting of Time and Price 

• Future Plotting of Time and Price 

• Gann level plotter 

• Gann Swing chart v41212 

• Gann Swing Charts in 3 modes with text 

• GFX ToolTip 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Harmonic Patterns 

• Heatmap V1 

• Heikin Ashi Candles 

• Heikin Ashi Delta 

• HH-LL-PriceBar 

• Historical Volatility Index 

• Historical Volatility Scan - 6/100 

• Historical Volatility Scan - 50 Day 

• Hull Rate of Return Indicator 

• IB Backfiller 

• IchimokuBrianVioreIRO 


SECTION BEGIN - section begin marker 
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• Improved NH-NH scan / indicator 

• In Watch List 

• Inside Bar 

• Inside Bar 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 

• Intraday Strength 

• Intraday Trend Break System 

• Inverted Plotted Volume Overlay Indicator 

• JEEVAN'S SRI CHAKRA 

• Kiss and Touch with the Modified True Range 

• Last Five Trades Result Dashboard - AFL code 

• Luna Phase 

• MACD Histogram - Change in Direction 

• Manual Bracket Order Trader 

• Market Breadth Chart-In-Chart 

• Market Facilitation Index VS Volume 

• mitalpradip 

• Modified Head & Shoulder Pattern 

• Modified-DVI 

• MS Darvas Box with Exploration 

• Multiple Ribbon Demo 

• NASDAO 100 Volume 

• Neural Network Powered Smooth/Predictive RSI V2 

• Nick 

• Non-repaitning Zigzag line 

• NoorDoodie 

• Now Send Push Notifications From Amibroker 

• Option Calls, Puts and days till third friday. 

• Parametric Chande Trendscore 

• Percentage Price Oscillator 

• Pivots And Prices 

• Plot the Equity Curve without Backtesting? 

• Plot visual stop / target ratio. 

• Point & figure Chart India Securities 

• Position Sizer vers2, stocks and CFDs 

• Positive Bars Percentage 

• prakash 

• Random Walk Index 

• Rene Rijnaars 

• Rl - Auto Trading System 

• Robert Antony 

• Scale Out: Futures 

• Square of Nine Roadmap Charts 

• Stochastic %J - KDJ 

• Stochastic Oscillator 

• Stops on percentages 

• Stress with SuperSmoother 

• SUPER PIVOT POINTS 

• Super Trend Indicator 

• TD Channel-1 

• TD Channel-2 


SECTION BEGIN - section begin marker 
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• TD Moving Average 2 

• TD Moving Average I 

• TD REI 

• TD Sequentiai 

• Trending Ribbon 

• TrendingRibbonArrowsADX 

• Triangular Moving Average new 

• TTM Squeeze 

• Twiggs Money Flow 

• TWS trade plotter 

• Ultimate plus 

• UltraEdit editor highlight wordfile 

• Vikram's Floor Pivot Intraday System 

• Visible Min and Max Value Demo 

• Volume Occilator 

• VWAP - Volume Weighted Average Price 

• William's Alligator System II 

• ZigZag filter rewrited from scratch in AFL 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


SECTION BEGIN- section begin marker 
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_SECTION_END 
- section end marker 


Exploration / Indicators 

(AFL 2.70) 


SYNTAX _SECTION_END() 


RETURNS NOTHING 

FUNCTION marks end of drag-drop section 

EXAMPLE 

SEE ALSO 
References: 

The _SECTION_END function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• 10-20 Indicator 

• 2 Timeframes Candlestick Bar Chart 

• 3TF Candlestick Bar Chart 

• Advanced MA system 

• Advanced Trend Lines with S & R 

• AFL Example 

• AFL to Python COM Link 

• AFL_Glossary_Converter 

• ALJEHANI 

• Animated BackGround 

• Animated BackGround 1.1 

• AO-rMomentum 

• Aroon The Advisor 

• Auto Trader Basic Flow 

• Automatic Linear Trend Channel 2 

• Automatic trend channel 

• Automatic Trendlines using multiple timeframes 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• Average Price Crossover 

• babaloo chapora 

• Bad Tick Trim on 5 sec database 

• Basket Trading System T101 

• Bid Vs Ask Dashboard 

• Bman's HaDiffCO 

• Bollinger Band Width 

• Button trading using AB auto trading interface 

• Candle Identification 

• Candle Stick Demo 

• Chandelier Exit 

• Chandelier Exit 

• changing period moving average 

• Chart Zoom 

• CoinToss ver 1 

• Colorfull Price 


SECTION END - section end marker 
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• com-out 

• Commodity Selection Index (CSI) 

• Continuous Contract Rollover 

• Coppock Histogram 

• Coppock Trade Signal on Price Chart 

• Coppock Trade Signal v1.1 

• Daily High Low in Advance 

• Dave Landry PullBack Scan 

• DEBAJ 

• Digital indiactors 

• DiNapolis 3x Displaced Moving Averages 

• Dynamtic Momentum Index 

• Elder Impulse Indicator V2 

• Elder Ray - Bull Bear 

• Elder Ray Oscillator with MA 

• Elder safe Zone Long + short 

• Elder Triple Screen Trading System 

• Elder's Market Thermometer 

• Elliott Wave Oscillator 

• Expiry day/days - Last thursday of month 

• FastStochK FullStochK-D 

• Fibonacci Calculations & Speed Resistance 

• Fibonacci Internal and External Retracements 

• Fibonacci Moving averages 

• Force index 

• Ere 

• Future MA Projection 

• Gann level plotter 

• Gann Swing chart v41212 

• Gann Swing Charts in 3 modes with text 

• GFX ToolTip 

• Graphical sector analysis 

• Graphical sector stock amalysis 

• Harmonic Patterns 

• Heatmap V1 

• Heikin Ashi Candles 

• Heikin Ashi Delta 

• HH-LL-PriceBar 

• Historical Volatility Index 

• Historical Volotility Scan - 6/100 

• Historical Volotility Scan - 50 Day 

• Hull Rate of Return Indicator 

• IB Backfiller 

• ICHIMOKU SIGNAL TRADER 

• IchimokuBrianVioreIRO 

• Improved NH-NH scan / indicator 

• In Watch List 

• Inside Bar 

• Inside Bar 

• Intraday Fibonacii Trend Break System 

• INTRADAY HEIKIN ASHI new 

• Intraday Strength 


SECTION END - section end marker 
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• Intraday Trend Break System 

• Inverted Plotted Volume Overlay Indicator 

• JEEVAN'S SRI CHAKRA 

• Kiss and Touch with the Modified True Range 

• Last Five Trades Result Dashboard - AFL code 

• Luna Phase 

• MACD Histogram - Change in Direction 

• Manual Bracket Order Trader 

• Market Breadth Chart-In-Chart 

• Market Facilitation Index VS Volume 

• mitalpradip 

• Modified Head & Shoulder Pattern 

• Modified-DVI 

• MS Darvas Box with Exploration 

• Multiple Ribbon Demo 

• NASDAO 100 Volume 

• Neural Network Powered Smooth/Predictive RSI V2 

• Non-repaitning Zigzag line 

• NoorDoodie 

• Now Send Push Notifications From Amibroker 

• Option Calls, Puts and days till third friday. 

• Parametric Chande Trendscore 

• Percentage Price Oscillator 

• Pivots And Prices 

• Plot the Equity Curve without Backtesting? 

• Plot visual stop / target ratio. 

• Point & figure Chart India Securities 

• Position Sizer vers2, stocks and CFDs 

• Positive Bars Percentage 

• prakash 

• Random Walk Index 

• Rene Rijnaars 

• Rl - Auto Trading System 

• Robert Antony 

• Scale Out: Futures 

• Square of Nine Roadmap Charts 

• Stochastic %J - KDJ 

• Stochastic Oscillator 

• Stops on percentages 

• Stress with SuperSmoother 

• SUPER PIVOT POINTS 

• Super Trend Indicator 

• TD Channel-1 

• TD Channel-2 

• TD Moving Average 2 

• TD Moving Average I 

• TD REI 

• TD Sequential 

• Trending Ribbon 

• TrendingRibbonArrowsADX 

• Triangular Moving Average new 

• TTM Squeeze 


SECTION END - section end marker 
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• Twiggs Money Flow 

• TWS trade plotter 

• Ultimate plus 

• UltraEdit editor highlight wordfile 

• Vikram's Floor Pivot Intraday System 

• Visi-Trade 

• Visible Min and Max Value Demo 

• Volume Occilator 

• VWAP - Volume Weighted Average Price 

• William's Alligator System II 

• Woodie's CCI Panel Full Stats 

• ZigZag filter rewrited from scratch in AFL 

• ZigZag Hi Lo Barcount 

• ZigZag Retracements 

• ZLEMA ATR Long Only Trading System 

More information: 

Updated on-line reference 


SECTION END- section end marker 
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_SECTION_NAME 
- retrieve current section name 


Exploration / Indicators 

(AFL 2.70) 


SYNTAX _SECTION_NAME() 

RETURNS STRING 

FUNCTION The function that gives the name of the drag-drop section (given in previous 
_SECTION_BEGIN caii). 


EXAMPLE 

SEE ALSO _SECTION_BEGIN() function 

References: 


The _SECTION_NAME function is used in the foilowing formulas in AFL on-line library: 

• ALJEHANI 

• Elder Triple Screen Trading System 

• UltraEdit editor highlight wordfile 

More information: 


Updated on-line reference 


SECTION NAME - retrieve current section name 
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_TRACE 

- print text to system debug viewer 


Miscellaneous functions 

(AFL 2.4) 


SYNTAX _TRACE("string") 

RETURNS NOTHING 

FUNCTION Write debug messages from AFL code to system debug viewer (it caiis internaiiy 

OutputDebugString Win API function) or to internai Log window (Window->Log) To view 
debug messages sent to system debugger you have to run DebugView freeware program 
from http://www.sysinternais.com/Utiiities/DebugView.htmi To view messages sent to internai 
iog window you need to dispiay iog window (Window->Log menu) 


Note for internai viewer: you can specify _TRACE("!CLEAR!"); to ciear internai log window 

EXAMPLE _TRACE("Thisisatest"); 

_TRACE("This is selected value of close:" + Close ); 

_TRACE("This is first element of close array:" + Close[ 0 ]); 

SEE ALSO 
References: 


The _TRACE function is used in the following formulas in AFL on-line library: 

• Pivots And Prices And Swing Volume 

• Auto Trade Step by Step 

• Auto Trader Basic Flow 

• AutoTrade using an Exploration 

• AutoTrader Basic Flow - updated April 15, 2009 

• AutoTrader Basic Flow - updated Nov 18, 2008 

• babaloo chapora 

• Button trading using AB auto trading interface 

• Calculate composites for tickers in list files 

• CCI(20) Divergence Indicator 

• Congestions detection 

• Detailed Equity Curve 

• Ed Seykota's TSP: EMA Crossover System 

• Ed Seykota's TSP: Support and Resistance 

• Herman 

• lastNDaysBeforeDate 

• MFE and MAE and plot trades as indicator 

• Ord Volume 

• Pivot Finder 

• Plot visual stop / target ratio. 

• Scale Out: Futures 

• shailu lunia 

• suresh 

• Volume Color with Dynamic Limit 

• WLBuildProcess 


TRACE - print text to system debug viewer 
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More information: 

Updated on-line reference 


TRACE- print text to system debug viewer 
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_TRACEF 

- print formatted text to system debug viewer 


Miscellaneous functions 

(AFL 4.0) 


SYNTAX _TRACEF("format string", arg1,) 

RETURNS NOTHING 

FUNCTION This function is the same as _TRACE but the very first argument is printf-styie formatting 

string and it aiiows to output formatted numbers iike combination of _TRACE and StrFormat. 

The function writes debug messages from AFL code to system debug viewer (it caiis 
internaiiy OutputDebugString Win API function) or to internai Log window (Window->Log) 

To view debug messages sent to system debugger you have to run Debug View freeware 
program from http://www.sysinternals.com/Utiiities/DebugView.htmi 

To view messages sent to internai log window you need to display log window (Window->Log 
menu) 


Note for internal viewer: you can specify _TRACE("!CLEAR!"); to clear internal log window 
EXAMPLE _TRACEF("Close price is = %g", Close ); 

SEE ALSO _TRACE() function 

References: 


The _TRACEF function is used in the following formulas in AFL on-line library: 

More information: 


Updated on-line reference 


TRACEF - print formatted text to system debug viewer 
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AFL Error List 

• Error 1. Operation not allowed. Operator/operand type mismatch. 

• Error 2. Incorrect type of argument. Expecting number or array here. 

• Error 3. Type mismatch, Unary minus operator requires number or array 

• Error 4. Incorrect type of argument(s). Expecting number here. 

• Error 5. Argument #1 has incorrect type (the function expects different argument type here) 

• Error 6. Condition in IF, WHILE, FOR statements has to be Numeric or Boolean type. You can not use 
array here 

• Error 7. Condition in IF, WHILE, FOR statements has to be Numeric or Boolean type. You can not use 
STRING here 

• Error 8. Type mismatch, the value assigned to the array element has to be a number. You can not 
use array... 

• Error 9. Array subscript has to be a number 

• Error 10. Subscript out of range. You must not access array elements outside 0..(BarCount-1) range 

• Error 11. Subscript operator [] requires array or number type. String can not be used here. 

• Error 12. Subscript operator [] requires array or number type. 

• Error 13. Endless loop detected in WHILE loop 

• Error 14. Endless loop detected in DO-WHILE loop 

• Error 15. Endless loop detected in FOR loop 

• Error 16. Too many arguments 

• Error 17. Missing arguments 

• Error 18. COM object variable is not initialized or has invalid type (valid COM object handle required) 

• Error 19. COM method/function 'function name' call failed. 

• Error 20. COM Method/function '%s' does not exist 

• Error 21. Relative strength base symbol not found 

• Error 22. Bad 'format' argument type - format has to be a number (not array) 

• Error 23. GetExtraData call failed 


AFL Error List 
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• Error 24. This formula requires AmiBroker version (or higher). 

• Error 25. SetVariableQ called from plug in was not successful. Identifier is already used in a different 
context. 

• Error 26. File handle passed to the function is invalid (equal to zero). 

• Error 27. Invalid number of arguments passed to Call Function (..) from plugin DLL 

• Error 28. Out of memory 

• Error 29. Variable used without having been initialized. 

• Error 30. Syntax error 

• Error 31. Syntax error, expecting 'list of tokens' 

• Error 32. Syntax error, probably missing semicolon at the end of the previous line 

• Error 33. The identifier is already in use. You attempted to assign value to the identifier representing a 
function. 

• Error 34. The identifier is already in use. You attempted to define the function that has the same 
identifier as global variable. 

• Error 35. Shift+BREAK pressed. Loop terminated. 

• Error 36. N-th argument of the function call has no value set 

• Error 37. Unsupported field in SetOptions 

• Error 38. Unsupported field in GetOptions 

• Error 39. CategoryAddSymbol: Setting sector is unsupported, set industry instead 

• Error 40. CategoryRemoveSymbol: Removing from sector is unsupported, remove from industry 
instead 

• Error 41. Unsupported field in GetRTData 

• Error 42. #include failed because the file does not exist: 'filename' (current working directory is '...') 

• Error 43. Variable stops are not supported in Rotational Trading mode 

• Error 44. SectorlD() is outside 0..63 range. 

• Error 45. Failed to launch trading interface 

• Error 46. Missing comma 

• Error 47. Exception occurred during AFL formula execution 


AFL Error List 
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• Error 48. N-volume bar compressed data longer than base time frame. Use higher compression 
factor. 

• Error 49. Optimization parameter name must not be empty. 

• Error 50. Optimization parameter minimum value must be less than or equal to maximum and step 
parameter needs to be greater than zero. 

• Error 51. Array subscript has Null value. Subscript must be within O...BarCount-1 range. 

• Error 52. Invalid argument value for name() function. Argument 'paramname' must be positive (and 
not Null) 

• Error 53. You have N open file(s) that you forgot to close. You must call fclose() function for every file 
opened with Error 54. Incorrect espace sequence. Supported sequences are \n, \r, \t, \" and W (gives 
single backslash) 

• Error 90. Specified Optimizer Engine not found 

• Error 91. OptimizerSetOption expects STRING value 

• Error 92. OptimizerSetOption expects NUMBER (scalar numeric) value 

• Error 93. Specified option is not supported / not available by the selected optimizer 

• Error 94. External Optimizer is not selected. You must call OptimizerSetEngine() prior to calling 
OptimizerSetOptionO 

• Warning 501. Assignment within conditional. Did you mean == instead of = ? 

• Warning 502. You are calling Plot()/PlotOHLC() function over 500 times, it is highly inefficient. Reduce 
number of Warning 503. Using OLE / 

CreateObject / CreateStaticObject is not multi-threading friendly. 

• Error 701. Missing buy/sell variable assignments 

• Error 702. Missing short/cover variable assignments 

• Error 703. Rotational trading requires PositionScore variable. 

• Error 704. In Rotational trading you must NOT use buy/sell/short/cover signals. 

• Error 705. You can not use HoldMinBars together with Allow Same Bar exit. 

• Error 706. Show Arrows feature needs a Trade list. 


AFL Error List 
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Error 1. Operation not allowed. Operator/operand type mismatch. 

An arithmetic, string, iogicai or comparison operator is being used with an invaiid data type. This error wouid 
occur, for exampie, if you were to attempt to muitipiy two string vaiues. 


a 

b 


z 


"x" 

"x" 

"x" 


■k 


+ 


5; // wrong, can not multiply string by number 

"y"; // wrong, can not subtract strings 

"y"; // correct, concatenation of strings is OK 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 2. Incorrect type of argument. Expecting number or array here. 

This occurs when calling single-argument mathematical function like sin() which accepts only numbers and 
arrays, 

but the user specified string for example. 

x= sin ("test"); // sin requires number or array 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 3. Type mismatch, Unary minus operator requires number or array 

Occurs when trying to apply unary minus operator to strings. 

text2 = - "test"; // can not use unary minus (negation) to texts 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 4. Incorrect type of argument(s). Expecting number here. 

This occurs in AppiyStop function when Type, Mode, ExitAtStop or Voiatiie parameter is an array 


// wrong - stop mode (precent/point) 
AppiyStop ( stopTypeLoss, Ilf ( C > O, 


can not be array 

stopModePercent, stopModePoint 


5 ) ; 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 5. Argument #1 has incorrect type (the function expects different argument type here) 

This error occurs when argument passed during function caii has invaiid type. For exampie when you pass 
string instead of array 

MA ( "test", 5 ); // wrong. Moving average expects array as first argument 
AddColumn ( "Test" , "Caption"); // wrong, AddColum expects array as first argument 

AddTextColumn ( "Test" , "Caption"); // correct, AddTextColumn expects text 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 6. Condition in iF, WHiLE, FOR statements has to be Numeric or Booiean type. You can not use 
array here, piease use [] (array subscript operator) to access array eiements 

The if keyword executes statementi if expression is true (nonzero); if eise is present and expression is faise 
(zero), it executes statement2. After executing statementi or statement2, controi passes to the next 
statement. Expression must be boolean ( True/False) type (so it CANNOT be ARRAY because there would be 
no way do decide whether to execute statementi or not, if for example array was: 

[True,True,False, ,False,True]) 

if( expression) 
statementi; 

eise 

statement2; 

EXAMPLE 

if( Close > Open ) // WRONG 

Color = colorGreen; //statement 1 

else 

Color = colorRed; //statement 2 
Plot (Close, "Colored Price" ,Color, styleCandle); 

The above example is wrong, as both Open and Close are arrays and such expression as Close > Open is 
also an ARRAY. The solution depends on the statement. It’s either possible to implement it on bar-by-bar 
basis, with use of FOR loop: 


for ( i = 0 ; i 

< 

BarCount; i++ ) 

1 

if ( Close[ 

i 

] 

> Open[ i ] ) // CORRECT 

Color [ 

i 

] 

= colorGreen; 

else 




Color[ 

i 

] 

= colorRed; 


} 


Plot ( Close, "Colored Price", Color, styleCandle ); 

It is also possible in this case to use llf() function: 

Color = IIf( Close > Open, colorGreen, colorRed ) ; // ALSO CORRECT - working 
directly on arrays 

Plot ( Close, "Colored Price", Color, styleCandle ); 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 7. Condition in iF, WHiLE, FOR statements has to be Numeric or Booiean type. You can not use 
STRiNG here. 

Occurs when you attempt to use string as a condition in if/whiie/for statements. 

For example: 

if ( "text" ) // incorrect 

{ 

// do something 
X = 1; 

} 

The condition in if/while/for should evaluate to true/false: 

if ( "text" != "someothertext" ) // correct, != (not equal to) operator gives 

true/false value 
{ 

// do something 
X = 1; 

} 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 8. Type mismatch, the value assigned to the array element has to be a number. You can not use 
array on the right-side of this assignment. 

Occurs on attempt to assign entire array to singie eiement of another array 


test = 0; 

for ( i = 0; i < BarCount; i++ ) 

{ 

test [ i ] = Close ; // wrong, single array element can take only one value, 
not array 


test[ 1 ] = Closet 1 ]; // correct 


} 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 9. Array subscript has to be a number 

You can use only numbers as array subscripts, strings and arrays are not accepted: 

tablet 1 ] = 10; // correct 
tablet "text" ] = 10; // incorrect 
tablet Close ] = 10; // incorrect 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 10. Subscript out of range. You must not access array elements outside 0..(BarCount-1) range 

Occurs when you attempt to access array elements with subscripts below 0 (zero) or above BarCount-1. 

// incorrect 

for ( bar = 0; bar < BarCount; bar++ ) 

{ 

a[ bar ] = C[ bar - 1]; // when i == 0 we are accessing C[-l] which is wrong 

} 


// correct 

f or ( bar = 0; bar < BarCount; bar++ ) 

{ 

if ( bar > 0 ) 

a[ bar ] = C[ bar - 1 ]; // only access C[ i - 1 ] when i is greater 

than zero 

else 

a[ bar ] = C[ 0 ] ; 

} 

One of most common mistakes is using hard coded upper limit of for loop and assuming that all symbols have 
enough quotes. 

For example: 

MyPeriod = 10; 

for ( i = 0 ; i < MyPeriod; i++ ) // WRONG ! this assumes that you always have at 

least 10 quotes ! 

{ 

// ... do something 

} 

This will always fail on symbols that have less quotes than 10 and it may also fail if you zoom your chart in so 
less than 10 quotes are actually displayed on the chart. 

To ensure error-free operation you must always check for upper index being LESS than BarCount, like shown 
in the code below: 

MyPeriod = 10; 

f or ( i = 0; i < MyPeriod AND i < BarCount; i++ ) // CORRECT - added check for 

upper bound 
{ 

// ... do something 

} 


Alternativelly you can enter the loop only when there are enough bars, like shown in this code: 

MyPeriod = 10; 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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if ( MyPeriod <= BarCount ) 
loop 
{ 

for ( i = 0; i < MyPeriod; 

{ 

// ... do something 

} 

} 


// CORRECT - 

i++ ) 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 11. Subscript operator [] requires array or number type. String can not be used here. 

Occurs when you attempt to use subscript operator [] on strings, for exampie: 

tt = "Test"; 

X = tt[ 0 ]; 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 12. Subscript operator [] requires array or number type. 

Occurs when subscript operator [] is appiied to some other unsupported type (such as COM object dispatch)): 

a=CreateObject ( "Broker.Application" ) ; 
b = a [ 0 ] ; 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 13. Endless loop detected In WHILE loop 

Occurs when AFL engine detect the while loop that never ends (the detection is based on number of 
iterations, AmiBroker simply counts the number of iterations and if it exceeds the threshold limit set in 

Tools->Preferences->AFL: Endless loop detection threshold - by default 100000 iterations) it displays this 
message). Example: 

i = 0; 

while ( i<5) x=i; // i variable is not incremented, so the loop never ends. 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 14. Endless loop detected In DO-WHILE loop 

Occurs when AFL engine detect the do-while loop that never ends (the detection is based on number of 
iterations, AmiBroker simply counts the number of iterations and if it exceeds the threshold limit set in 

Tools->Preferences->AFL: Endless loop detection threshold - by default 100000 iterations) it displays this 
message). Example: 

i = 0; 

do 

{ 

X = i; 

} 

while ( i < 5 ); // i variable is not incremented, so the loop never ends. 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 15. Endless loop detected In FOR loop 

Occurs when AFL engine detect the for loop that never ends (the detection is based on number of iterations, 
AmiBroker simply counts the number of iterations and if it exceeds the threshold limit set in 

Tools->Preferences->AFL: Endless loop detection threshold - by default 100000 iterations) it displays this 
message). Example: 

for ( i = 0; i < BarCount; i ) // forgotten ++ (increment operator) so the loop 

never ends. 

{ 

X = i; 

} 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 16. Too many arguments 

Occurs when too many arguments were specified when caiiing the function. For exampie: 

m = MACD ( 12, 26, 3 ); // error: MACD needs only 2 parameters, but 3 are 
specified 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 17. Missing arguments 

Occurs when too few arguments were passed during function caii. Exampie: 

Plot ( C, "Price" ); // too few arguments, 3rd argument is required - color of the 
plot 


Error 1. Operation not allowed. Operator/operand type mismatch. 


1201 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


Error 18. COM object variable is not initialized or has invalid type (valid COM object handle required) 

Occurs on attempt to use uninitialized variable or variable of incorrect type to call COM object methods: 

Obj =1; // initialize as number 

Obj.Test 0; // attempt to call method fails because Obj is not COM object handle 


Error 1. Operation not allowed. Operator/operand type mismatch. 


1202 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


Error 19. COM method/function <function name> call failed. <More lnfo> 

An OLE exception occurred during OLE/COM method/function/property caii. <More info may contain 
OLE exception description. 

Commonly this is displayed when arguments passed to the OLE/COM method are incorrect or missing. 

AB=CreateOb ject ( "Broker.Application" ) ; 

AB.Import 0; // <— fails with error 19. In this case because of missing 
arguments 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 21. Relative strength base symbol not found 

RelStrengthQ function called with non-existing symbol as a parameter; 

X = RelStrength ( "NonExistingTicker" ); // fails because of wrong symbol 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 22. Bad 'format' argument type - format has to be a number (not array) 

Format parameter specified in AddCoiumn() function caii shouid be a number (not array). Exampie 

AddColumn ( C, "Close", IIf( C > 10, 1.2, 1.3 ) ); // wrong, format parameter 

(3rd) has to be a number 

AddColumn ( C, "Close", 1.3 ); // correct 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 23. GetExtraData call failed 

GetExtraDataO failed (or returned no value) either because current plugin does not support GetExtraData 
function or field specified is not supported by the plugin: 

x=GetExtraData ( "nonexistingfieldname" ); // wrong field name 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 24. This formula requires AmiBroker version <...> (or higher). 

The formula is intended to be used on higher version of AmiBroker and you should upgrade in order to use it. 

Version ( 9.7 ); // there is no version 9.70 yet :-) 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 25. SetVariable() called from plug In was not successful. Identifier Is already used In a different 
context. 

Happens if external plugin attempts to call SetVariable with identifier that is already used for some other 
purpose 

(like built-in or user-defined function) 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 26. File handle passed to the function is invalid (equal to zero). You have to check if file handle 
returned by fopen is not equal to zero. If it is zero it means that file could not be opened. 

Occurs on attempt to call file write/read/close function on null file handle. 

Example (Incorrect): 

fh = fopen ( "nonexistingfile.txt" , "r"); // this file does not exist 

fputs ( "Test" , fh ); // error here, fh could be null 
fclose ( fh ); // wrong, fh could be null 

Correct usage would look like this: 

fh = fopen ( "nonexistingfile.txt" , "r"); // this file does not exist 

if ( fh ) // correct, call subsequent file read/write/close only when file handle 

Is OK 
{ 

fputs ( "Test" , fh ); 
fclose ( fh ); 

} 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 27. Invalid number of arguments passed to Call Function (..) from plugin DLL 

Occurs only when external plugin calls Internal AmiBroker functions with Incorrect number of arguments. 


Error 1. Operation not allowed. Operator/operand type mismatch. 


1210 



AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


Error 28. Out of memory 

Out-of-memory error occurred during parsing the formuia (shouid not happen under normai circumstances) 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 29. Variable <name> used without having been initialized. 

You can not use (read) the variable that was not initialized first. You should assign the value to the variable 
before reading it. 

Example (incorrect usage): 

x=l; 

z = X + y; // wrong, y is not initialized 

Correct usage would look like this: 


X = 1 ; // initialize x 

y = 2; // initialize y 

z = X + y; // correct, both x and y are initialized 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 30. Syntax error 

General syntax error. Occurs when the syntax is incorrect (for example unbalanced parentheses, or 
unrecognized characters or invalid operators or incorrect/undefined function name or missing brace or 
semicolon ) 


X = 4; 
y = 2; 

z=x* (7+y; // syntax error here because of missing closing parenthesis 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 31. Syntax error, expecting <list of tokens> 

Occurs The syntax is incorrect because the parser expects specifies tokens and finds something eise. 
For example: 

while i < 5 // this generates Error 31. Syntax error, expecting '(' 

- the parser expects opening brace '(' after while statement 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 32. Syntax error, probably missing semicolon at the end of the previous line 

General syntax error occurred at the beginning of the line. In most cases it happens because of missing 
semicolon at the end of the statement in the previous line, see this: 


a=5 

b=4; // <- here syntax error probably missing semicolon 

but on some occassions the reason may be simply incorrect syntax at the beginning of the line: 

a=5 ; 

+b=4; // < — the same error message but the problem is about an extra + character 
at the beginning of the line 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 33. The identifier is aiready in use. You attempted to assign vaiue to the identifier representing a 
function, if you want to return vaiue from function you shouid use RETURN statement instead. 

Example 1: 

function Test( x ) 

{ 

return 2 * x; 

} 

VarSet ( "Test", 7 ); // error, identifier 'Test' is already used for function 

Example 2: 

(Incorrect) 

function Test( x ) 

{ 

Test = 2 * x; // error here because Test identifier is already used for 
function, 

// you should use return statement to return values from function 

} 

X = Test ( 5 ); 

Correct function returning value would look like this: 

function Test( x ) 

{ 

return 2 * x; // correct, returning values using return statement 

} 

X = Test ( 5 ); 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 34. The identifier is aiready in use. You attempted to define the function that has the same 
identifier as giobai variabie. 

Occurs when function definition uses the same identifier as giobai variabie defined eariier in the formuia. 

Test = 5; // global variable 

function Test( x ) // incorrect, 'Test' identifier is already used for global 

variable 
{ 

return 2 * x; 

} 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 35. Shift+BREAK pressed. Loop terminated. 

Occurs when user manually terminates loop execution by pressing Shift+BREAK keys. 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 36. N-th argument of the function call has no value set 

May happen if N-th argument of the function is set to no vaiue. This can not happen under normai 
circumstances, but oniy when caiiing functions from inside the piugin or by setting variabies from inside piugin. 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 37. Unsupported field in SetOptions 

Occurs when wrong (or not supported) field name was used in SetOption call, for example: 

SetOption ( "NoSuchOption" , 1 ) ; 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 38. Unsupported field in GetOptions 

Occurs when wrong (or not supported) field name was used in GetOption call, for example: 

X = GetOption ("NoSuchOption"); 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 39. CategoryAddSymbol: Setting sector is unsupported, set industry instead 

Occurs when categorySector is used in CategoryAddSymboi function. You can not add symboi to sector 
because symbois are iinked to industry groups oniy and industry groups are then assigned to sectors. One 
sector usualiy includes several industry groups and if you set the industry then sector is implict. Refer to 
AmiBroker Users Guide for more information about categories. 

CategoryAddSymbol ( categorySector, 2 ); // wrong, you can not use 

categorySector 

CategoryAddSymbol ( categoryIndustry, 2 ); // correct 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 40. CategoryRemoveSymbol: Removing from sector is unsupported, remove from industry 
instead 

Occurs when categorySector is used in CategoryRemoveSymboi function. You can not remove symboi from 
sector because symbois are iinked to industry groups only and industry groups are then assigned to sectors. 
One sector usually includes several industry groups and if you set the industry then sector is implict. Refer to 
AmiBroker Users Guide for more information about categories. 


CategoryRemoveSymbol ( 
categorySector 


categorySector, 2 ); // wrong, you can not use 


CategoryRemoveSymbol ( 


categoryIndustry, 2 ); // correct 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 41. Unsupported field in GetRTData 

Occurs when not supported field was specified in GetRTData call: 

GetRTData ( "EPSRank" ) ; // EPSRank is not available from RT sources 

Note that GetRTData is supported only for real-time data sources and in Professional edition only. If you 
attempt to call it without running RT data source or using AmiBroker Standard edition, it will quietly return Null 
value without displaying any error message. 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 42. #include failed because the file does not exist: <filename> (current working directory is 


Occurs when specified inciude fiie does not exist. Exampie: 

#include "not\existing\path\to\the\file.afl" 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 43. Variable stops are not supported in Rotational Trading mode 

Occurs on attempt to use variable amount in ApplyStopQ function when using rotational trading backtester 
mode. Example: 

EnableRotationalTrading () ; 

ApplyStop ( stopTypeLoss, stopModePoint, H-L ); // variable stop amount not 
supported in rotational mode 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 44. SectorlDQ is outside 0..63 range. 

May occur during call to SectorlD() function if external data plugin sets sector IDs incorrectly (outide 0..63 
range) 


X = SectorlDO; // the formula is correct, but may fail with error 44 if data 
plugin sets sectors incorrectly 


Error 1. Operation not allowed. Operator/operand type mismatch. 


1227 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


Error 45. Failed to lauch trading interface 

Problem occurs when formula calls GetTradIngInterface but required Interface Is not Installed or registered 
properly. 

ti = GetTradingInterface ( "DUMMY" ); // fails because DUMMY interface is not 

installed 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 46. Missing comma 

Problem occurs when there is a missing comma in the function declaration formal parameter list 

function MyFun( x y ) // missing comma in the formal parameter list 

{ 

return x * y; 

} 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 47. Exception occurred during AFL formuia execution 

This error occurs when formula caused unhandled system exception. System exception may be due to 
memory overflow, accessing incorrect file handle, memory access violation, etc. 

Example: 

fclose ( 123 ) ; // closing invalid file handle causes system exception 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 48. N-volume bar compressed data longer than base time frame. Use higher compression factor. 


This error occurs when N-volume compression setting produces data longer than original data set. 

N-volume bars are very different from time-based bars(compression of data to N-volume bar may actually 
deliver MORE output bars - for example if one tick is 1000 shares and you have specified 100V bars then 
single tick will be expanded to TEN 100V bars - ten times original size) 

TimeFrame functions are protected against array overrun and will not decompress beyond original array size 
(you will get an "Error 48"). Also switching main time frame to some weird N-volume bar value will result in 
limiting the output to maximum twice original data size(without error message). 

You should keep that in mind and avoid using too small N-volume bar intervals that could lead to such 
condition. Also due to the nature of N-volume bars the only TimeFrameSet() function will yield correct 
N-volume bar values, TimeFrameGetPrice() may give slightly distorted results. 

Example: 

TimeFrameMode ( 2 ); 

TimeFrameSet ( 20 ); // possible Error 48 - 20-share bar compression may be too 
small 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 49. Optimization parameter name must not be empty. 

This error occurs when Optimize() function is caiied with empty name argument. 

Exampie: 

period = Optimize , 10, 10, 20, 1 ); // WRONG: name must NOT be empty 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 50. Optimization parameter minimum vaiue must be iess than or equai to maximum and step 
parameter needs to be greater than zero 

This error occurs when AFL's Optimize() function is caiied with minimum vaiue greater than maximum or step 
iess not greater than zero 

Exampie: 

period = Optimize ( "Period" , 1, 20, 10, 1 ); // WRONG: minimum > maximum 
period2 = Optimize ( "Period2" , 1, 10, 20, 0 ); // WRONG: step = 0 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 51. Array subscript has Null value. Subscript must be within O...BarCount-1 range. 

You attempted to use Null value as array subscript 


index = Null; 

value = Closet index ]; // error 51. 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 52. Invalid argument value for <name> function. Argument <paramname> must be positive (and 
not Null). 

Error 52. Invalid argument value for <name>() function. The function does not support <paramvalue> 
specified. 

You attempted to pass a negative value as a parameter to a function that expects positive values or the 
function does not accept given value of parameter. 

Sum( Close, -15 ); // error 52 - range must be positive 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 53. You have N open file(s) that you forgot to close. You must call fclose() function for every file 
opened with fopenQ 

You called fopen() to open files but failed to call fclose. 

fh = fopen ( "test.txt" , "w" ) ; 

if( fh ) 

{ 

// fclose( fh ); // fclose() SHOULD be called 

} 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 54. Incorrect \ espace sequence. Supported sequences are \n, \r, \t, \" and W (gives single 
backslash) 

You have specified incorrect espace sequence in the string constant. Supported sequences are \n - for new 
iine, \r - for carriage return, \t - for tab, \" for quotation mark, W - single backslash. 


fh = fopen ( "C:\windows\test.txt" , "w"); // Error 54 - incorrect espace sequence 

WRONG - a single backslash should be encoded as \\ 
fh = fopen ( "C:\\windows\\test.txt" , "w" ) ; // CORRECT 

fclose ( fh ); 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 90. Specified Optimizer Engine not found 

OptimizeSetEngine function was called with non-existing engine name 

OptimizerSetEngine ( "test" ); // Error 90 - such engine does not exist 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 91. OptimizerSetOption expects STRING value 

OptimizerSetOption function expects string for given optionargument 

OptimizerSetOption ( "a_string_field", 1 ); // Error 91 - incorrect argument 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 92. OptimizerSetOption expects NUMBER (scalar numeric) value 

OptimizerSetOption function expects number for given option argument 


OptimizerSetOption ( "a_nuineric_field", "string"); // Error 91 - incorrect argument 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 93. Specified option is not supported / not avaiiabie by the seiected optimizer 

OptimizerSetOption function called with unsupported option name. 

OptimizerSetOption ( "NoSuchOption", 1); // Error 93 - no such option in external 

engine 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 94. External Optimizer is not selected. You must call OptimizerSetEngine() prior to calling 
OptimizerSetOptionO 

You must call OptImIzerSetEngIne before calling any other Optimizer... functions. 

// OptimizerSetEngine("cmae"); // Not called but SHOULD BE 

OptimizerSetOption ( "runs" , 1); // Error 94 - you must call OptimizerSetEngine 
before callign OptimizerSetOption 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Warning 501. Assignment within conditionai. Did you mean == instead of = ? 

You attempted to do assignment inside if/whiie/for statements or inside IIF function. This may be a mistake 
because chances are that you meant to compare numbers not to assign them. Remember that == is equaiity 
check, not =. By using = you don't compare but assign a value to variable. If you really mean to assign inside 
conditional statement use extra braces. 

if ( X = 5 ) // warning, you are assigning 5 to variable x 

{ 

} 

if ( X == 5 ) // correct - you probably meant to COMPARE instead (note == 

operator) 

{ 

} 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Warning 502. You are calling Plot()/PlotOHLC() function over 500 times, it is highly inefficient. Reduce 
number of calls. 

You are calling Plot()/PlotOHLC() function over 500 times, it is highly inefficient. Reduce number of calls. 

It is important to understand that Plot() function involves plotting entire chart and that is rather costly. If you 
want to draw segmented line generated using for example LineArray, don't call Plot() multiple times. Instead 
combine all LineArrays into one and use single Plot call. 

for ( i = 0; i < 600; i++ ) 

{ 

xO = ..; 
xl = ..; 
yO = ..; 
yl = .. ; 

Plot ( LineArray ( xO, xl, yO, yl ), colorRed ); // DO NOT DO THIS ! 

} 

Instead use single Plot(): 

CombinedLlne = Null; 
for ( i = 0; 1 < 600; i++ ) 

{ 

xO = .. ; 
xl = ..; 
yO = . . ; 
yl = .. ; 

La = LineArray! xO, xl, yO, yl ); 

CombinedLlne = Ilf ( IsNull ( la ), CombinedLlne, la ); // combine lines 

} 

Plot! CombinedLlne, colorRed ); // THAT IS PROPER WAY - one call to Plot that 

does all the plotting in one shot 


For more examples see also http://www.amibroker.org/userkb/2007/04/20/plotting-trade-zigzag-lines/ 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Warning 503. Using OLE / CreateObject / CreateStaticObject is not muiti-threading friendiy. 

Your formula contains CreateObject and/or CreateStatic object calls. While they are still supported, the 
performance of OLE in multi-threaded applications is poor, and you should consider replacing OLE with native 
AFL commands that do the same. 

AB = CreateObject ( "Broker.Application" ); // OLE is slow 

AmiBroker fully supports calling OLE objects from AFL formula level, and it is still safe to use, but there are 
technical reasons to advocate against using OLE. The foremost reason is that OLE is slow especially when 
called not from "owner" thread. 

OLE was developed by Microsoft back in 1990's in the 16-bit days it is old technology and it effectivelly 
prevents threads from running at full speed as all OLE calls must be served by one and only user-interface 
thread. For more details see this article: 

http://blogs.msdn.eom/b/oldnewthing/archive/2008/04/24/8420242.aspx 

For this reason, if only possible you should strictly avoid using OLE / CreateObject in your formulas. 

If you fail to do so, the performance will suffer. Any call to OLE from a worker thread causes posting a 
message to OLE hidden window and waiting for the main application Ul thread to handle the request. If 
multiple threads do the same, the performance would easily degrade to single-thread level, because all OLE 
calls are handled by main Ul thread anyway. 

You should consider replacing OLE with native AFL commands that do the same. 

For more details see Efficient use of multithreading 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 701. Missing buy/seii variabie assignments. 

The formula that you are trying to backtest does not contain proper Buy and Sell rules. Buy and Sell rules 
should be written as assignments as shown below: 

Buy = Cross ( Close, MA ( Close, 50 ) ) ; 

Sell = Cross ( MA ( Close, 50 ), Close ) ); 

For more details see Tutorial: Backtesting your trading ideas 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 702. Missing short/cover variabie assignments. 

The formula that you are trying to backtest does not contain proper Short and Cover rules. Short and Short 
rules should be written as assignments as shown below: 

Short = Cross ( MA ( Close, 50 ), Close ) ); 

Cover = Cross ( Close, MA ( Close, 50 ) ) ; 

If you do not want to test the short side, please go to the Settings and select Long from Positions 
combo-box. This will allow you to test long side only. 

For more details see Tutorial: Backtesting your trading ideas 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 703. Rotational trading requires PositionScore variable. 

When trying to use the Rotational backtest mode you must define PositionScore variable that decides how 
symbols are ranked and sorted. Example PositionScore assignment is presented below: 

EnableRotationalTrading () ; 

SetOption ( "WorstRankHeld" , 5 ) ; 

PositionSize = -25; // invest 25% of equity in single security 
PositionScore = 50 - RSI(); // THIS IS REQUIRED for rotational mode 

For more details see Rotational Trading mode 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 704. In Rotational trading you MUST NOT use buy/sell/short/cover signals. 

When trying to use the Rotational backtest mode you must not use buy/sell/short/cover variable assignments 

EnableRotationalTrading () ; 

SetOption ( "WorstRankHeld" , 5 ) ; 

PositionSize = -25; // invest 25% of equity in single security 
PositionScore = 50 - RSI(); // required for rotational mode 

Buy = Cross ( C, MA ( C, 50 ) ); // WRONG - can not use that in rotational mode 


On the other hand, if you want to use Buy/Sell/Short/Signals and just prioritize them - use regular backtest 
mode. For that, remove EnableRotationalTrading function call. 

For more details see Rotational Trading mode 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 705. You can not use HoldMinBars together with Allow Same Bar exit 

You can not mix HoldMinBars option with AllowSameBarExit 

SetOption ( "AllowSameBarExit" , True ) ; 

SetOption ( "HoldMinBars" , 5 ); // ERROR - these two do not mix 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Error 706. Show Arrows feature needs a Trade list. 

You attempted to use "Show arrows" feature (or double clicked on Analysis result list) but AmiBroker can not 
display trading arrows unless you run backtest with Report mode set to Trade List. You would need to go to 
the Settings window, Report tab, and change Result list shows to Trade list (the default setting). 

For more information see Tutorial: Using New Analysis window and the Settings window 


Error 1. Operation not allowed. Operator/operand type mismatch. 
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Calculating multiple-security statistics with AddToComposite function 


The vast majority of AFL functions operate on singie security prices. The are two exceptions from this ruie 
provided by RelStrengthQ and ForeignQ functions. These two functions aiiow you to use other security 
prices in the AFL formuia. Aithough these functions are very usefui for things iike reiative performance charts, 
they are not so usefui for tasks requiring prices of aii securities (or a iarge number of securities) because one 
wouid need to type severai hundreds of Foreign() function caiis to do so. Moreover this approach wouid 
require iisting aii the ticker names within the formuia which makes the formuia tight to particuiar market. We 
obviousiy need compieteiy different approach... 

Just imagine if we were abie to store the resuits of caicuiations performed on singie security somewhere and 
then use those partiai data to generate some muitipie security indicator. You may say that one can create the 
expioration, then export the resuits to the CSV fiie, then ioad it into Excei and then perform the caicuiations 
there. It wouid work (in some cases) but you have to agree that the soiution is not nice. 

This is the area where AddToComposite function can heip. 

Basciaiiy the concept behind AddToComposite is that we run our formuia (using Scan feature) through a 
group of symbois performing some caicuiations. We wiii compute some muitipie security statistics and store 
the resuits in the artificiai ticker created using AddToComposite function. 

2.3 The solution 

The key to the soiution is the foiiowing aigorithm: 

1. Do some ordinary AFL caicuiations using any of avaiiabie functions 

2. Add the resuit of the caicuiations to one of the O, H, L, C, V, I fieids of our artificai ticker (named for 
exampie "-composite") 

When the above procedure is repeated over a group of symbois our composite ticker wiii contain the sum of 
resuits of individuai symboi caicuiations. 

Step 2 described above is impiemented entireiy inside AddToComposite function: 


SYNTAX 

AddToComposite( array, "ticker", "fieid", fiags = atcFiagDefauits ) 

RETURNS 

NOTHING 

FUNCTION 

Allows you to create composite indicators with ease. 

Parameters: 

array - the array of values to be added to "field" in "ticker" composite symbol 
"ticker" - the ticker of composite symbol. It is advised to use -comp (tilde at 
the beginning) 

newly added composites are assigned to group 253 by default and 
have "use only local database" feature switched on for proper operation with 
external sources 


possible field codes: "C" - close , "0" - open, "H" - high, "L" - low, "V" - volume, 
"1" - open interest, "X" - updates all OHLC fields at once, "1" - aux1 field, "2" - 
aux2 field 


flags - contains the sum of following values 
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• atcFlagResetValues = 1 - reset values at the beginning of scan 
(recommended) 

• atcFlagCompositeGroup = 2 - put composite ticker into group 253 and 
EXCLUDE all other tickers from group 253 (avoids adding composite 
to composite) 

• atcFlagTimeStamp = 4 - put last scan date/time stamp into FullName 
field 

• atcFlagEnableInBacktest = 8 - allow running AddToComposite in 
backtest/optimization mode 

• atcFlagEnablelnExplore = 16 - allow running AddToComposite in 
exploration mode 

• atcFlagResetValues = 32 - reset values at the beginning of scan (not 
required if you use atcFlagDeleteValues) 

• atcFlagEnableInPortfolio = 64 - allow running AddToComposite in 
custom portfolio backtester phase 

• atcFlagDefaults = 7 

(this is a composition of atcFlagResetValues | 
atcFlagCompositeGroup | atcFlagTimeStamp flags) 


AddToComposite function also detects the context in which it is run 
(it works ONLY in scan mode, unless atcFlagEnableInBacktest or 
atcFlagEnablelnExplore flags are specified) and does NOT affect composite 
ticker when run in Indicator or Commentary mode, so it is now allowed to join 
scan and indicator into single formula. 

EXAMPLE AddToComposite( MACD() > 0, "-BullMACD", "V"); 

graphO = Foreign("~BullMACD", "V"); 

(now you can use the same formula in scan and indicator) 

AddToComposite function opens up a huge variety of interesting applications. The following examples will 
help you understand what you can do with AddToComposite function. 

Example 1: 

Let's say we want to create custom index (average of prices of multiple tickers). With AddToComposite 
function you can do this fairly easy: 

/* AddToComposite statements are for analysis -> Scan */ 

/* add Close price to our index OHLC fields */ 

AddToComposite(Close, "~MyIndex", "X" ) ; 

/* add one to open intest field (we use this field as a counter) */ 
AddToComposite( 1, "~MyIndex", "I" ) ; 

buy =0; // required by scan mode 

/* this part is for Indicator */ 

graphO = Foreign( "~MyIndex", "C" )/Foreign( "~MyIndex", "I" ); 

You should use above the formula in the Analysis -> Scan mode (over the group of symbols of your choice). 
This will create "-Myindex" artificial ticker that will contain your index. 
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Shortly this formula just adds Close price to OHLC fields (the "X" field stands for all OHLC) of our artificial 
ticker -Myindex. Additionally we add "1" to "I" (open interest) field - effectivelly counting the number of 
symbols scanned. We can use symbol count later on to divide the sum of prices by the number of symbols 
included (the last line of the formula above ). 

Example 2: 

In the second example we will show how to calculate the indicator that shows the number of symbols meeting 
certain criterion. In this example this would be RSI less than 30 (oversold condition), but it can be anything 
you like. 

So the first line of our formula will be: 

values = rsi() < 30; 

This will store "true" in the values array for all date points when RSI is less than 30. Then we add regular 
AddToComposite part: 

buy = 0; // do not generate signals 
AddToComposite( values, "-MyComposite", "V" ); 

If we run the formula using "Scan" function of the Analysis window the result would be an artificial symbol 
"-MyComposite" filled with quotations. The Volume field of those quotes will contain the number of symbols 
meeting our criterion (RSI<30) in the population of scanned symbols. 

You can easily see the chart of this new "indicator" using the following custom formula: 

graphO = foreign("-MyComposite", "V"); 

High values of this "indicator" show that most of the symbols in the analysed group are oversold. This usually 
happens before a great rise of the whole market. We just created market-wide oversold detector! 

Example 3: 

In the third example I will show you how to use the same technique to count the number of open positions of 
your trading system. This is useful if you want to know how big account would you need to trade your system 
following all the trades. Our formula will be very similar to the one before. 

First we should have our original trading system formula: 

/* Your original formula here */ 

/* In this example this is simple macd/signal crossover system) 

buy = cross ( macd(), signal () ); 

sell = cross( signal(), macd() ); 

/* the following line uses Flip function to get "1" after the buy 
signal and reset it back to "0" after sell appears. */ 

in_trade = flip( buy, sell ) ; 

AddToComposite( in_trade, "-OpenPosCount", "V" ); 
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We use "-OpenPosCount" artificial ticker to store the results. Again we should run just Scan of the formula 
and the "-OpenPosCount" ticker would become available. 

Use 


graphO = foreign( "~OpenPosCount", "V"); 

after running the back-test to see the chart of the number of open positions of your system. 

2.4 Notes 

For mode details on composites check "Introduction to AddToComposite" (122KB PDF) by Herman van den 
Bergen. 

Please note that to update any composite ticker (for example after adding/editing quotes) you should run 
"Scan" again. 

The idea was originally presented in the 12/2001 issue of AmiBroker tips newsletter. Special thanks to Mr. 
Dimitris Tsokakis for very constructive discussions that allowed creation and enhancements of this idea. 
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Equity function, Individual and Portfolio Equity Charts 

Introduction 


The equity line is probably the best diagnostic tool for trading system developer. In one graph it shows the 
sum total of the success or failure of the system being tested, and the resulting effect on your equity. 

Numbers from Report telling of a drawdown is nice but with a graph, one can see how things were going 
before, during, and after a drawdown. 

The line produced by the equity function tracks the amount of equity in your account. So, for example, if you 
backtest a system over the last year, you should see that, at the beginning of that year, the line starts at the 
amount of your your initial equity, and then rises and falls because, as each trade makes or loses money, the 
equity in your account will rise and fall. It shows how much money is in your account throughout the backtest 
period, so you can visually see how your system performed. 

So, clearly you dont want to see the line go down - that means you lost money. It is generally accepted that 
you want to revise your system test parameters in order to get as close as possible to a smooth, straight, 
rising line. This means that your system has performed consistantly over time, and presumably over different 
market conditions. A line that goes up and down frequently means that your system works well only under 
certain conditions, and poorly under other conditions. 

Individual (single-security) Equity chart 


To display single security Equity chart is is enough to click on the drop down arrow on the "Equity" button and 
choose "Individual Equity" from the menu in the Automatic Analysis window AFTER running a backtest. 
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This will plot the equity for currently active symbol and recently backtested system. If you want to see the 
Equity curve for another symbol - just switch to this symbol and Equity line will be recalculated automatically. 

You can also choose symbol that was not included in the original backtest set and AmiBroker will calculate 
correct equity curve as it would look if real backtest was performed on it. 

IMPORTANT: individual equity chart is single-security equity that does not show portfolio-level effects like 
skipping some of trades due to reaching maximum open position limit or funds being allocated to other 
securities, it also does not use some advanced functionality offered only by portfolio-level backtester. For 
more information see this. 

Portfolio-level Equity chart 

To display portfolio-level equity chart is is enough to double click on "Equity" button in the Automatic Analysis 
window or click on the drop down arrow on the "Equity" button and choose "Portfolio Equity" from the menu 
AFTER running a backtest. 
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Portfolio-level equity represents equity of your entire portfolio and reflects ALL real-world effects like skipping 
trades due to insufficient funds, reaching maximum number of open positions. It also reflects all scaling in/out, 
HoldMinBars effect, early exit fees and any other feature that you may have been using in your formula. 
Portfolio-level equity also by default shows the remaining cash in the portfolio. Using Parameters window 
(click with RIGHT mouse button over equity chart and select "Parameters" from the menu) you can turn on 
display of drawdown (underwater equity curve), number of bars sincel last equity high and linear regression of 
the equity. 



Equity function 

EquityO function is a single-security backtester-in-a-box. It has many interesting applications that will be 
outlined here. Let's look at the definition of Equity function: 


SYNTAX equity( Flags = 0, RangeType = -1, From = 0, To = 0 ) 

RETURNS ARRAY 

FUNCTION Returns Equity line based on buy/sell/short/cover rules, 

buy/sell/short/coverprice arrays, all apply stops, and all other backtester 
settings. 

Flags - defines the behaviour of Equity function 

0 ; (default) Equity works as in 3.98 - just calculates the equity 
array 

1 : works as 0 but additionally updates buy/sell/short/cover 
arrays so all redundant signals are removed exactly as it is 
done internally by the backtester plus all exits by stops are 
applied so it is now possible to visualise ApplyStopO stops. 

2 : (advanced) works as 1 but updated signals are not moved 
back to their original positions if buy/sell/short/cover delays 
set in preferences are non-zero. Note: this value of flag is 
documented but in 99% of cases should not be used in your 
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formula. Other values are reserved for the future. 

RangeType - defines quotations range being used: 

-1 : (default) use range set In the Automatic analysis window 
0 : all quotes 

1 : n last quotes (n defined by 'From' parameter) 

2 : n last days (n defined by 'From' parameter) 

3 : From/To dates 

From : defines start date (datenum) (when RangeType == 3) or "n" parameter 
(when RangeType == 1 or 2) 

To: defines end date (datenum) (when RangeType == 3) otherwise Ignored 

datenum defines date the same way as DateNumQ function as YYYMMDD 
where YYY Is (year - 1900), MM Is month, DD Is day 

December 31st, 1999 has a datenum of 991231 
May 21st, 2001 has a datenum of 1010521 

All these parameters are evaluated at the time of the call of Equity function. 
Complete equity array Is generated at once. Changes to buy/sell/short/cover 
rules made after the call have no effect. Equity function can be called multiple 
times In single formula. 

EXAMPLE buy = your buy rule; 

sell = your sell rule; 
graphO = Equlty(); 

SEE ALSO 


Using Equity function we can build up Equity "Indicator" that will work without the need to run backtester. Just 
type the following formula In the Formula Editor and press Apply: 

buy = ... your buy rule ... 
sell = .... your sell rule ... 

graphO = Equity(); 

EquItyO function uses the buy/sell/short/cover rules that are defined BEFORE this function Is called. The 
whole backtesting procedure Is done Inside Equity function that generates equity line. 

Notes: 

1. Equity line Is dependant of the parameters In the Automatic Analysis settings 

2. Equity traces Interest Earnings when you are OUT of the market. 

If you don't want this just enter 0 Into "Annual Interest rate" field In the settings. 

3. Equity also traces commissions. If commissions are not zero entry commission Is taken using position 
size of the entry and exit commission Is taken for each point to simulate how much money would you 
have If you closed position at given bar. 

4. AmiBroker uses Sell Price array for long trades and CoverPrIce array for short trades to calculate 
current equity value. 
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5. EquityO function is singie-security and does not refiect portfoiio-ievei effects iike skipping trades, does 
not handie some advanced functionaiity offered oniy by portfoiio-backtester. For more information see 
that tabie. 

Portfolio Equity special symbol 

After running portfoiio-ievei backtest, AmiBroker writes the values of portfolio equity to special symbol 
"—EQUITY". This allows you to access portfolio-level equity of last backtest inside your formula. To do so, 
use Foreign function: 

PortEquity = Foreign (" - EQUITY", "C" ) ; 

This is exactly what for example built-in portfolio equity chart formula is doing. 

Can I calculate system statistics using Equity function? 

Yes you can. Here is a couple of example calculations kindly provided by Herman van den Bergen: 

E = Equity(); 

//How rich you were :-) 

Plot (Highest(E,"I should have sold",1,3); 

//Your Current Drawdown: 

Plot(Highest(E) - E,"Current DrawDown",4,1); 

//Trade profits: 

LongProfit = Ilf(Sell,E - ValueWhen(Buy,E),0); 

ShortProfit = Ilf(Cover,ValueWhen(Short,E)-E,0); 

Plot (Ilf(Sell,LongProfit,0),"LProfit",8,2 + 4) ; 

Plot(Ilf(Cover,ShortProfit,0),"SProfit" , 4,2 + 4) ; 

//Current Trade Profit: 

Lastbar = Cum(l) == LastValue( Cum(l) ); 

Plot(Ilf(LastBar AND pos,E-ValueWhen(Buy,E),ValueWhen(Short,E) - 
E),"Current Profit",9,2+4); 

//DailyProfits: 

Plot (Ilf(pos,E-Ref(E,-l),Ref(E,-l)-E) , "Daily Profits",7,2); 

How do you plot a composite Equity Curve ? I don't want the whole database, but would like to see the 
curve based on the watchlist I use for the backtesting. 

Just use Portfolio Level equity chart (see above). It represents actual portfolio backtest equity, so if you run 
your backtest on the watch list it will represent what you need. You can also write your own formula that does 
the same thing: 

Plot ( Foreign (" - EQUITY", "C" ), "PL Equity", colorRed ); 
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Functions accepting variabie periods 

The following functions support variable periods (where periods parameter can be array and change from bar 
to bar): 


• AMA 

• AMA2 

• DEMA 

• HHV 

• HHVBars 

• LinRegSlope 

• LinearReg 

• LinRegIntercept 

• LLV 

• LLVBars 

• MA 

• Ref 

• StdErr 

• Sum 

• TEMA 

• TSF 

• WMA 


Functions accepting variable periods 
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User-definable functions, procedures. Local/global scope 

User-definable functions allow to encapsulate user code into easy-to-use modules that can be user in many 
places without need to copy the same code over and over again. 

Functions must have a definition. The function definition includes the function body — the code that executes 
when the function is called. 

A function definition establishes the name, and attributes (or parameters) of a function. A function definition 
must precede the call to the function. The definition starts with function keyword then follows function name, 
opening parenthesis then optional list of arguments and closing parenthesis. Later comes function body 
enclosed in curly braces. 

A function call passes execution control from the calling function to the called function. The arguments, if any, 
are passed by value to the called function. Execution of a return statement in the called function returns 
control and possibly a value to the calling function. 

If the function does not consist of any return statement (does not return anything) then we call it a procedure. 
Following is an example of function definition: 

// the following function is 2nd order smoother 

function IIR2( input, fO, fl, f2 ) 

{ 

result [ 0 ] = input [ 0 ]; 
result [ 1 ] = input [ 1 ]; 

for ( i = 2; i < BarCount; i++ ) 

{ 

result [ i ] = fO * input [ i ] + 

f1 * result [ i - 1 ] + 
f2 * result [ i - 2 ]; 

} 

return result; 

} 


Plot ( Close, "Price", colorBlack, 

Plot( IIR2( Close, 0.2, 1.4, -0.6 


styleCandle ); 

), "function example". 


colorRed 


In this code IIR2 is a user-defined function, input, fO, f1, f2 are formal parameters of the functions. 

At the time of function call the values of arguments are passed in these variables. Formal parameters behave 
like local variables. 

Later we have result and i which are local variables. Local variables are visible inside function only. If any 
other function uses the same variable name they won't interfere between each other. 

Due to the fact that AFL does not require to declare variables the decision whenever given variable is treated 
as local or global is taken depends on where it is FIRST USED. 


User-definable functions, procedures. Local/global scope 


1262 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


If given identifier appears first INSIDE function definition - then it is treated as LOCAL variabie. 

If given identifier appears first OUTSIDE function definition - then it is treated as GLOBAL variabie. 

This defauit behaviour can be however overriden using global and local keywords (introduced in 4.36) - see 
example 2. 

Example (commentary): 

k = 4; // this is GLOBAL variable 

function f( x ) 

{ 

z = 3; // this is LOCAL variable 

return z * x * k; // 'k' here references global variable k (first used above 
outside function) 

} 

z = 5; // this is GLOBAL variable with the same name as local variable in 
function f 

"The value of z before function call :" + WriteVal ( z ); 

// Now even if we call function 

// the value of our global variable z 

// is not affected by function call because 

// global variable z and local variable z are separate and 

// arguments are passed by value (not by reference) 

"The result of f( z ) = " + WriteVal ( f( z ) ) ; 

"The value of z after function call is unchanged : " + WriteVal ( z ); 

Example 2: Using local and global keywords to override default visibility rules: 

VariableA =5; // implict global variable 

function Test() 

{ 

local VariableA; // explicit local variable with the same identifier as 
global 

global VariableB; // explicit global variable not defined earlier 

// may be used to return more than one value from the 

function 

VariableA = 99; 

VariableB = 333; 


VariableB =1; // global variable 

"Before function call"; 

"VariableA = " + VariableA; 
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"VariableB = " + VariableB; 

Test () ; 

"After function call"; 

"VariableA = " + VariableA + " (not affected by function call )"; 

"VariableB = " + VariableB + " (affected by the function call )" 

At the end of the function we can see 'return' statement that is used to return the resuit to the cailer. Note that 
currently return statement must be placed at the very end of the function. 

It is also possible to write a procedure (a function that returns nothing (void)) 

procedure SinePlotter( Freq, Colorindex ) 

{ 

pname = "Line"+WriteVal (Colorindex,1 .0 ); 
array = sin ( Cum ( Freq * 0.01 ) ) ; 

Plot ( array, pname , colorRed + Colorindex, styleThick ); 

} 

for ( n = I; n < 10; n++ ) 

{ 

SinePlotter( n/2+Cum ( 0.01 ), n ); 

} 

Note that although there are two separate keywords 'function' and 'procedure' AmiBroker currently treats them 
the same (they both accept return values but not require them), but in the future the rules maight get enforced 
to use 

return statement ONLY in conjunction with function keyword. So it is advised to use function keyword in case 
when your function returns any value and procedure keyword otherwise. 

Note also that recursion (having a function call itself from within itself) is NOT supported as for now. 

More information 

Please read also Understanding how AFL works article to learn more. 
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AFL Tools 

Automatic technical analysis 

Introduction 

Since version 2.5 AmiBroker features automatic technicai anaiysis toois. AmiBroker can check for user 
defined buy/seii conditions giving you an idea about the current situation on the market. It can aiso perform a 
system test (simuiation) teiiing you about the performance of your trading system. Version 3.0 of AmiBroker 
introduced new formuia ianguage (AFL) aiiowing you to write not oniy system tests but aiso custom indicators 
and guru advisor commentaries. 

In order to do this you have to define buy and sell rules, indicator formulas or commentaries using a special 
AmiBroker Formula Language (AFL), which is described below. For more information about using analysis 
tools see also the description of the Automatic analysis window, Formula Editor, and Commentary window in 
Chapter 2. 

AmiBroker Formula Language 

AFL is used for defining your trading rules and explorations in Automatic analysis window, custom 
commentaries in the Guru Commentary window and indicator formulas in Formula Editor window. 

Detailed reference of AFL language is given here. 

Examples 

Below you will find some simple buy and sell rules. They are just formal equivalents of some of the most 
common indicators interpretation rules. You can treat them as a starting point for developing your own 
trading strategies, but before you get too excited when you think you've found the "holy grail" of trading 
systems, check the following: 

• Test the system on different symbols and different time frames. The results should be similar to those 
on the original data tested. 

• Test the system on different types of markets (e.g., upward trending, downward trending, and 
sideways). A good system should work in all types of markets, since you won't always know when a 
market changes from trending to trading or vice versa. 

• Pay close attention to the number of trades generated by a trading simulation. If there are a large 
number of trades and large profits, be sure you specified realistic commissions. The results of the test 
may be much different once commissions are factored in. 


buy = 

cross( 

macd(), 0 ); 



sell 

= cross 

( 0, macdO ) 

r 


buy = 

cross{ 

ema( close. 

9 ), ema( close, 15 ) 

) ; 

sell 

= cross 

( ema( close. 

15 ), ema( close, 9 ) 

); 

buy = 

cross{ 

rsi (), 30 ); 



sell 

= cross 

( 70, rsiO ) 

r 


buy = 

cross( 

ultimate(), 

50 ) ; 


sell 

= cross 

( 50, ultimate() ); 
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Automatic analysis window 

Automatic analysis window enables you to check your quotations against defined buy/sell rules. AmiBroker 
can produce report telling you if buy/sell signals occurred on given symbol in the specified period of time. It 
can also simulate trading, giving you an idea about performance of your system. 

In the upper part of window you can see text entry field. In this field you should enter buy and sell rules. These 
rules are assignment statements written in AmiBroker's own language. You can find the description of this 
language in AFL reference guide. 

In order to make things work you should write two assignment statements (one for buy rule, second for the 
sell rule), for example: 

buy = cross( macd(), 0 ) ; 
sell = cross( 0, macd() ) ; 

Automatic analysis window allows you also to optimize your trading system and perform in-depth explorations 
See also: detailed description of Automatic Analysis window controls 

Formula Editor 

Formula Editor allows you to write formulas to be used as indicators or in Automatic Analysis window. More 

on this 

here. 

Guru Advisor Commentary window 

Commentary window enables you to view textual descriptions of actual technical situation on given market. 
Commentaries are generated using formulas written in AmiBroker's own formula language. You can find the 
description of this language in AmiBroker Formula Language Reference Guide. 

Moreover Commentary feature gives you also graphical representation of buy & sell signals by placing the 
marks (arrows) on the price chart. 

NOTE: Using complex commentary formulas you may observe long execution times. 

See also: detailed description of Guru Advisor Commentary window controls 
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AFL Scripting Host 

IMPORTANT NOTE: Since the introduction of native iooping and fiow controi statements iike if-else and while 
in version 4.40 the significance of scripting has been greatiy reduced. Currentiy most of the tasks requiring 
scripting in previous versions couid be bandied in native AFL. What's more AFL ioops are 3-6 times faster 
than JScript/VBScript. 

Basics 

AFL scripting host is an interface between AFL engine and JScript/VBScript engines (aka. 

Active Scripting technoiogies) avaiiabie as a part of Internet Toois & Technoiogies piatform 
provided by Microsoft. 

It allows you to build the formulas that are have parts in AFL code and parts in 
JScript/VBScript. 

Requirements 

• AmiBroker 3.59 or higher 

• Microsoft JScript/VBScript engines installed 

Microsoft JScript/VBScript engines come with Internet Explorer 4 or higher(Windows 98, 

Millenium, 2000 have it included in the operating system). It is however advised to install the 
latest version of Internet Explorer (5.5) or download and install the latest version of Windows 
Scripting Host (5.5) from Microsoft: 

Windows 95, 98, Me, NT: 

http://www.microsoft.com/scripting/downloads/v55/other/scr55en.exe 
Windows 2000: 

http://www.microsoft.eom/scripting/downloads/v55/windows2000/scripten.exe 

JScript/VBScript documentation can be found on official scripting page at: 
http://msdn.microsoft.com/scripting/ 

Enabling AFL Scripting Host 

If you want to use scripts within your formulas you have to call EnableScript() function 
in the beginning of your formula. The function takes one input parameter - engine name: 

EnableScript("jscript"); 


or 


EnableScript("vbscript") ; 

From then on, you will be able to embody parts written in scripting language in your formulas. 
The begin and the end of the script must be marked with <% and %> sequences, as shown in 
the example below: 

EnableScript("vbscript") ; 
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// "normal" AFL statements 
buy = cross( macd(), 0 ); 
sell = cross( 0, macd() ); 


your script code here 


// "normal" AFL statements 
buy = ExRem( buy, sell ) ; 

Using variables 

Currently the only way to exchange the Information between "normal" AFL part and script part 
Is to use variables. AFL scripting host exposes one object (predefined, no 
creatlon/lnitlallzatlon needed) 
called AFL. 

The AFL object has one (default) parametrized property called Var( varname ) that can be 
used to access AFL variables from the script side: 


// example in VBScript 
<% 


buyarrayfromscript = AFL.Var("buy") 

' get the buy array from AFL to the script-defined variable 

AFL.Var{"buy") = buyarrayfromscript 

' set the buy array in AFL from the script-defined variable 


since Var Is default property you can omit Its name and write simply AFL( varname ) as 
shown In the example below: 


buyarrayfromscript = AFL("buy") 

' gets the buy array from AFL to the script-defined variable 


AFL("buy") = buyarrayfromscript 

' sets the buy array in AFL from the script-defined variable 


In AFL there are three data types possible: array (of floating point numbers), a number 
(floating point) and a string. The VBScript and JScrIpt engines use variant data type that can 
hold any type of the variable Including three used by AFL. As In AFL, you don't declare 
variables In scripting languages, the type Is determined by the first assignment. In case of 
VBScript you can get/set AFL variables of any supported type using syntax shown above. But 
In JScrIpt, due to the fundamental difference In handling arrays In JScrIpt (array elements In 
JScrIpt are Implemented as dynamic properltes of an array object) you need to use the 
following code to get the value of AFL array Into JScrIpt array: 
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II example in JScript 
<% 

function GetArray( name ) 

{ 

return VBArray( AFL{ name ) ).toArrayO; 

} 

myJScriptArray = GetArray( "close" ); 

%> 

The GetArrayO function shown above makes it easy to convert automation-type safe array 
into JScript array. This exampie shows aiso how to define and use functions in JScript; 

Assigning AFL variabies from script-side arrays is much more simpie, AFL scripting host 
detects JScript arrays and can get their contents directiy: 

// example in JScript 
<% 

AFL ("buy") = myJScriptBuyArray; 

%> 

Aii other data types are bandied the same in JScript and VBScript 

// example in VBScript 
ticker = nameO; 

<% 

tickerstring = AFL("ticker") 

AFL ( "ticker") = "new name" 


or in JScript: 


// example in JScript 
ticker = nameO; 

<% 


tickerstring = AFL("ticker") ; 
AFL("ticker") = "new name"; 


Iterating through arrays 

One of the most basic task that everyone wouid probabiy do is to iterate through array. In 
VBScript this can be done using For..To..Next statement, in JScript using for(;;) statement. 
Both these constructs need to know array size or number of eiements in the array. In 
VBScript you shouid use UBound( arrary) function to get the upper bound of the array, in 
JScript you just use iength property of the array. The foiiowing exampies show this. (Piease 
remember that in both VBScript and JScript arrays are zero-based.) 


// example in VBScript 
<% 

myArray = AFL("close") 


sum = 0 

for i = 0 to UBounci( myArray ) 
sum = sum + myArray( i ) 
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next 

%> 

or in JScript: 

// example in JScript 
<% 

function GetArray( name ) 

{ 

return VBArray( AFL( name ) ).toArray(); 

} 

myArray = GetArray( "close" ); 
sum = 0; 

for( i = 0; i < myArray.length; i++ ) 

{ 

sum += myArray[ i ]; 

} 

%> 

Examples 

a) Indicator exampie - Exponentiai moving average: 

Enablescript ( "jscript"); 

<% 

close = VBArray( AFL( "close" ) ),toArray(); 

output = new Array(); 

// initialize first element 
output[ 0 ] = close [ 0 ]; 

// perform the loop that calculates exponential moving average 
factor = 0,05; 

for { i = 1; i < close.length; i++ ) 

{ 

output! i ] = factor * close! i ] + {1 - factor) * output! i - 1 ]; 

} 


AFL.Var{"graphO") = close; 
AFL.Var{"graphl") = output; 

%> 

WriteVal( graphl ) ; 


b) Profit-target stop exampie 
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Here comes the example of the formula that realizes profit-target stop at the fixed 10% 
percentage from the buy price. Note that buy condition Is met when the price reaches a new 
high, so It happens multiple times after Initial buy. Therefore ValueWhen( buy, close ) can not 
give you Initial buy price and that kind of trading rule could not be Implemented In AFL Itself. 
But, with scripting there Is no problem... 


EnableScript("VBScript"); 

hh = HHV( close, 250 ); 

// buy when prices reaches a new high 
buy = Close == HHV( close, 250 ); 

// ensure that sell is an array, 

// sell = 0 would set the type to number 
sell = buy; 


<% 


close = AFL("close") 
buy = AFL( "buy" ) 
sell = AFLC'sell") 


' this variable holds last buying price 
' if it is zero it means that no trade is open 
lastbuyprice = 0 

' iterate along the array 
for i = 0 to UBound( close ) 
sell( i ) = 0 


' Remove Buy signals if trade was already initiated 
if ( lastbuyprice > 0 ) then 
buy ( i ) = 0 
end if 


if there is no open trade and buy signal occurs 
' get the buying price 

if ( lastbuyprice = 0 ) AND (buy ( i ) = 1) then 
lastbuyprice = close( i ) 
end if 


' if trade is open and sell condition is valid 
' generate sell signal 
' and close the trade 

if (lastbuyprice >0 ) AND ( close ( i ) > ( 1.1 * lastbuyprice ) ) then 
sell( i ) = 1 
lastbuyprice = 0 
end if 
next 


AFL("buy") = buy 
AFLC'sell") = sell 


%> 


buy = buy; 
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Further information 

More scripting samples are available at the AFL on-line library at: 
http://www.amibroker.com/library/list.php 

In case of any further questions, comments and suggestions please contact me at: 
support@amibroker.com . Please note that AFL scripting is fairly advanced topic and you 
should play a little bit with AFL first before going too deep into scripting. 


Further information 


1272 


AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


Component Object Model support in AFL 

Introduction 

The Component Object Model (COM) is the technology that defines and implements mechanisms that enable 
software components, such as applications, data objects, controls, and services, to interact as objects. The 
COM support in AFL introduced in version 3.75beta allows to create instances of COM objects and call the 
functions (methods) exposed by those objects. 

The COM object can be created in virtually any language including any C/C++ flavour. Visual Basic, Delphi, 
etc. This enables you to write parts of your indicators, systems, explorations and commentaries in the 
language of your choice and run them at full compiled code speed. 

The scripting engines used by AFL scripting host (JScript and VBScript) also expose themselves as COM 
objects. AFL COM support now allows you to call functions defined in scripting part directly from AFL without 
the use of variables to pass the data to and retrieve data from the script. 

Calling functions defined in script 

Until version 3.75 the only way to exchange information between AFL and the script was using variables - this 
technique is explained in detail in AFL scripting host documentation . 

Let's suppose we need a function that calculates second order NR (infinite impulse response) filter: 
y[ n ] = fO * x[ n ] + f1 * y[ n - 1 ] + f2 * y[ n - 2 ] 

Please note that well known exponential smoothing is a first order MR filter. Implementing higher order filters 
minimizes lag, therefore our second order NR may be used as a "better" EMA. 

In the "old way" we would need to write the following code: 

EnableScript("jscript") ; 


X = 

^ ( High 

+ Low 

fO 

= 0.2; 


fl 

= 1.2; 


f2 

O 

1 

II 


"6 



X = 

: VBArray 

( AFL( 

fO 

= AFL( " 

fO" ); 

fl 

= AFL( " 

fl" ); 

f2 

= AFL( " 

f2" ); 


) .toArray() ; 


y = new Array(); 


// 

Yf 

Yf 


initialize 
0 ] = x[ 0 
1 ] = x[ 1 


first 2 elements of result array 

] ; 

] 
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for( i = 2; i < x.length; i++ ) 

{ 

y[i] =fO*x[i] +fl*y[i-l] +f2*y[i-2]; 

} 

AFL.VarC'y") = y; 

%> 


GraphO = Close; 

GraphOStyle = 64; 

Graphl = y; 

While it is OK for one-time use, if we need such a function multiple times we had to have repeat the script part 
which is not very nice. Much nicer approach is to have a function that can be called from multiple places 
without the need to repeat the same code. Defining functions in JScript of VBScript is no problem at all: 

EnableScript("jscript"); 


function IIR2( x, fO, fl, f2 ) 
{ 


X = VBArray ( x ) .toArrayO; 
y = new Array(); 

// initialize first 2 elements of result array 
y[ 0 ] = x[ 0 ]; 
y[ 1 ] = X[ 1 ]; 

for( i = 2; i < x.length; i++ ) 

{ 

y[i] =fO*x[i] +fl*y[i-l] +f2*y[i-2]; 

} 

return y; 


} 


.. but how to call such a function from AFL? 

The most important thing is that script engine exposes itself as a COM object. A new AFL function 
GetScriptObjectQ can be used to obtain the access to the script engine. The rest is simple - once we define 
the function in the script it is exposed as a method of script object retrieved by GetScriptObject: 

script = GetScriptObject0 ; 

GraphO = script.IIR2( ( High + Low )/2, 0.2, 1.2, -0.4 ); 

Graphl = script.IIR2( ( Open + Close )/2, 0.2, 1.0, -0.2 ); // call it again and 


Calling functions defined in script 


1274 



AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


again... 

Note also, that with this approach we may pass additional arguments so our IIR2 filter may be re-used with 
various smoothing parameters. 

So, thanks to a new COM support in AFL, you can define functions in scripts and call those functions from 
multiple places in your formula with ease. 

Using external COM/ActiveX objects in AFL 

In a very similar way we can call functions (methods) in an external COM objects directly from the AFL 
formula. Here I will show how to write such external ActiveX in Visual Basic but you can use any other 
language for this (Delphi for example is very good choice for creating ActiveX/COM objects). 

It is quite easy to create your own ActiveX DLL in Visual Basic, here are the steps required: 


• Run Visual Basic 

• In the "New project" dialog choose "ActiveX DLL" icon - this will create 
the "Projecti" that looks like in the picture on the right: 

• Now click on the (Name) and rename the "Projecti" to something more 
meaningfull, for example "MyAFLObject" 

• Then double click on the "Classi" in the project tree item. The code 
window will get the title of "MyAFLObject - Classi (Code)" as shown 
below: 


Fi jiecf ■ MyAFLUbiecI 


□ m C] 


B ^ MyAFLObject (MyAFLObject) 

B- Q class Modules 

(iSf Classi (Classi) 


MyAFLObject - Classi (Code) 



(General) 



(Declai ations) 

2 


Type code here 



• Now you are ready to enter the code 

As an example we will implement a similar function to one shown in the JScript. The function will calculate 
second order Infinite Impulse Response filter. We will call this function "IIR2" 


Public Function IIR2(InputArray() As Variant, fO As Variant, fl As Variant, f2 As 
Variant) As Variant 


Dim Result () 

ReDim Result(UBound(InputArray)) ' size the Result array to match InputArray 

'initialize first two elements 


Result(0) = InputArray(0) 
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Result (1) = InputArray( 1 ) 

For i = 2 To UBound(InputArray) 

Result (i) = fO * InputArray(i) + fl * Result(i - 1) + f2 * Result(i - 2) 

Next 

IIR2 = Result 

End Function 

The code is quite simiiar to the JScript version. The main difference is deciaring types. As you can see aii 
variabies passed from and to AFL must be deciared as Variants. This is so, because AmiBroker does not 
know what kind of object it speaks to and puts aii arguments to the most universai Variant type and expects 
the function to return the vaiue as Variant aiso. Currentiy AmiBroker can pass to your object fioating point 
numbers, arrays of fioating point numbers, strings, and pointers to other objects (dispatch pointers) - aii of 
them packed into Variant type. When you write the ActiveX, it is your responsibiiity to interpret Variants 
received from AmiBroker correctiy. 

Now you shouid choose Run->Start in Visuai Basic to compiie and run the component. The code in Visuai 
Basic wiii wait untii externai process accesses the code. 

To access the freshiy created ActiveX we wiii use the foiiowing AFL formuia (enter it in the Formuia Editor and 
press Appiy): 


myobj = CreateObject("MyAFLObject.Classl"); 

GraphO = Close; 

GraphOStyle = 64; 

Graphl = myobj.IIR2( Close, 0.2, 1.2, -0.4 ); 

The AFL formuia simpiy creates the instance of our ActiveX object and caiis its member function (IIR2). Note 
that we are using new dot (.) operator to access myobj members. 

Now ciick the "Appiy" button in the Formuia Editor to see how aii this setup works. You shouid see candiestick 
chart with a quite nice moving average. 

2.4 Conclusion 

Introduction of COM support in AFL brings even more power to AFL and AmiBroker. Now you can write 
indicators, trading systems, expiorations and commentaries using custom functions that are easy to create 
using scripting ianguage or fuii-featured deveiopment environment of Visuai Basic, Boriand Deiphi, C++ 
Buiider, Visuai C++ and many, many others. Using integrated deveiopment environments iike those 
mentioned makes debugging, testing and deveioping much easier and faster. Aiso resuiting compiied code 
executes severai times faster than interpreted script or AFL. 

But this is not the end of the story... C/C++ programmers can choose to write piugin DLLs that do not use 
COM technoiogy at aii. Piugin DLLs has some additionai features inciuding abiiity to caii back AFL buiit-in 
functions, directiy retreive and set AFL variabies and support automatic syntax coiouring of functions exposed 
by the piugin. This topic is covered in the AmiBroker Deveiopment Kit avaiiabie from the member's area of 
AmiBroker site. 


Using external COM/ActiveX objects in AFL 


1276 



AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


Using external COM/ActiveX objects in AFL 


1277 



AmiBroker 6.00 User's Guide 


AmiBroker Formula Language (AFL) 


Plug-in in AFL 

This section describes reguiar piug-in DLLs, if you are interested in ActiveX piugins check "COM support in 
AFL" section. 

Plugin interface 

AmiBroker Piugin interface aiiows to caii an externai moduie (DLL iibrary) directiy from AFL. Such a iibrary 
can expose muitipie functions that can be used in your trading systems, indicators, commentaries, scans and 
expiorations. The piugin DLL can be created using any C/C++ compiier, Deiphi and other ianguages 
supporting creation of reguiar DLLs. As the code of a piug in is complied to a native processor machine code 
it runs several times faster than AFL. Also since you can use full power of C/C++ (or other) language to build 
the most complex functions with ease. 

In addition to exposing functions to AFL, plugin DLLs have ability to call back AFL built-in functions, directly 
retreive and set AFL variables and support automatic syntax colouring of functions exposed by the plugin. 

A detailed description of plugin interface and the sample code of plug in DLL are included in the AmiBroker 
Development Kit (ADK). The ADK is available for registered users only (downloadable from members 
area). 

Getting 3rd party plugins 

Freeware 3rd party plugins are available for download from http://www.amibroker.net/3rdparty.php 

Using third-party plugins: 

To use third-party plugin DLL just copy the DLL file to the Plugins folder in the AmiBroker directory. Then run 
AmiBroker. Then choose Tools->Plugins menu. In the Plugins window you should see the list of all loaded 
plugin DLLs. If AmiBroker was running when you copied the DLL you should click on "Unload" and then on 
"Load" button. This will force rescanning the Plugins folder and loading the DLLs. 

When the plugin DLL is loaded the new functions exposed by this DLL become available to all your AFL 
formulas. For the list of functions exposed by plugin you should consult the documentation of the plugin itself. 

IMPORTANT NOTE: AmiBroker makes no representations on features and performance of 
non-certified third-party plug-ins. Specifically certain plug-ins can cause instabilities or even crashes. 
Entire use of non-certified third-party plugins is at your own risk. 
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Common Coding mistakes in AFL 

This document presents most common mistakes and probiems that users encounter when writing their 
custom formuias. Piease read carefuiiy to avoid making simiiar errors. 

• = (assignment) vs == (equaiity check) 

• Using parentheses 

• iif function 

• iif is for arrays, Writeif is for strings 

• if-eise statement needs booiean (or singie numeric expression), not array 

• Barcount vs Barindex() 

• TimeFrameExpand() is required to match data with originai time frame 


= (assignment) vs == (equality check) 

There are two simiiar iooking but compieteiy different operators in AFL. 

= is a variabie assignment operator 
== is an equaiity check operator 
EXAMPLE 
Incorrect code: 

result = IIf( Variable = 10 , High, Low ); // WRONG 

if you want to check if variabie is equai to 10, you MUST use “==” 

Correct code: 

result = IIf( Variable == 10 , High, Low ) ; // CORRECT 


Using parentheses 

Parentheses can be used to controi the operation precedence (the order in which the operators are 
caicuiated). AmiBroker aiways does operations within the innermost parentheses first. To iearn the the 
precedence of operations when parentheses are not used, visit: 
http://www.amibroker.com/guide/a_ianguage.htmi 

EXAMPLE: 

i wouid iike to buy whenever either Ciose is higher that its 10-periods Moving Average or Ciose is at ieast 
10% higher than yesterdays ciose, but buy shouid oniy appiy when Current Voiume is higher than its 
10-period Moving Average. Fiowever i get Buy signais for the days when Voiume is iower than 
MA(Voiume,10). Why? 

Buy = Close > MA ( Close, 10 ) OR Close == 1.1 * Ref ( Close, -1 ) AND Volume > MA ( 
Volvime, 10 ) ; 
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The solution is to add parentheses, otherwise system buys whenever Close > MA(Close,10) condition is met 
( or Close == 1.1*Ref(Close,-1) AND Volume > MA(Volume,10) are both met). 

Buy = ( Close > MA ( Close, 10 ) OR Close == 1.1 * Ref ( Close, -1 ) ) 

AND Volvime > MA( Volume, 10 ) ; 

Ilf function 

The llf() function is used to create conditional assignments, 
variable = llf( EXPRESSION, TRUE_PART, FALSE_PART ); 

The above "Ilf" statement means: For each bar EXPRESSION is true assign TRUE_PART to the variable, 
otherwise (when EXPRESSION is false) assign FALSE_PART. 

EXAMPLE 

Incorrect code 

Ilf ( Close > 10, result = 7, result = 9 ); // WRONG 

Correct code: 

result = IIf( Close > 10, 7, 9 ); // CORRECT 

Ilf Is for arrays, Writelf Is for strings 

Ilf functions should be used to handle arrays, if you need conditional text function use Writelf instead. 

EXAMPLE 

Incorrect code: 

variable = Ilf (Condition, "Text l","Text 2" ); // WRONG 

llf() function returns array, NOT STRING, so it’s impossible to assign text to variable with use of IIF. Use 
Writelf() function instead: 

Correct code: 

variable = Writelf ( condition, "Text 1", "Text 2" ); // CORRECT 

Please note however that Writelf function returns just single STRING, not arrays of strings, so only the 
selected value is used for evaluation. 

If-else statement needs boolean (or single numeric expression), not array 

The If keyword executes statement! if expression is true (nonzero); if else is present and expression is false 
(zero), it executes statement2. After executing statement! or statement2, control passes to the next 
statement. Expression must be boolean ( True/False) type (so it CANNOT be ARRAY because there would be 
no way do decide whether to execute statement! or not, if for example array was: 
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[True,True,False,.,False,True]) 

if( expression) 
statementi 

else 

statement2 

EXAMPLE 

if( Close > Open ) // WRONG 

Color = colorGreen; //statement 1 

else 

Color = colorRed; //statement 2 
Plot (Close, "Colored Price" ,Color, styleCandle); 

The above example Is wrong, as both Open and Close are arrays and such expression as Close > Open Is 
also an ARRAY. The solution depends on the statement. It’s either possible to Implement It on bar-by-bar 
basis, with use of FOR loop: 

for ( 1=0; i < BarCount; i++ ) 

{ 

if( Closet i ] > Opent i ] ) // CORRECT 

Color [ i ] = colorGreen; 

else 

Color [ i ] = colorRed; 

} 

Plot ( Close, "Colored Price", Color, styleCandle ); 

It Is also possible In this case to use llf() function: 

Color = Ilf ( Close > Open, colorGreen, colorRed ); // ALSO CORRECT - working 
directly on arrays 

Plot ( Close, "Colored Price", Color, styleCandle ); 


Barcount vs Barlndex() 

There Is a fundamental difference between BarCount and BarIndexQ. BarCount is a numeric variable that 
holds just one number (the count of elements In array). On the other hand BarlndexQ Is a function that returns 
ARRAY representing consecutive Index of each bar. 

EXAMPLE 

Incorrect code: 

for (i = 0; i < BarIndex ();i++ ) // WRONG 

{ 

// your formula 

} 


It’s not allowed to use ARRAY Inside for loop, and Barlndex() returns ARRAY. That Is why It’s necessary to 
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change the formula. 

Correct code: 

for (i =0 ; i < BarCount ;i++ ) // CORRECT 

{ 

//your formula 

} 


TimeFrameExpand() is required to match data with originai time frame 

The TimeFrameSet( ) replaces current price/volume arrays: open, high, low, close, volume, openint, avg with 
time-compressed bars of specified Interval once you switched to a different time frame all calculations and 
bullt-ln Indicators operate on selected time frame. To get back to original Interval call TimeFrameRestore( ) 
function. The TimeFrameExpand( ) Is used to decompress array variables that were created In different time 
frame. Decompressing Is required to properly display and use the array created In different time frame. 

EXAMPLE 

Incorrect code: 

TimeFrameSet ( inWeekly ) ; 

MA14_Weekly = MA ( Close, 14 ); 

TimeFrameRestore () ; 

Buy = Cross ( Close, MA14_Week;ly ); // WRONG - Close and MA15_Weekly use different 
time scales 

The above formula Is wrong, as MA14_Weekly variable should be EXPANDED to match original timeframe. 
The right contents should be: 

Correct code: 

TimeFrameSet ( inWeekly ) ; 

MA14_Weekly = MA ( Close, 14 ); 

TimeFrameRestore () ; 

Buy = Cross ( Close, TimeFrameExpand ( MA14_Weekly, inWeekly ) ) ; // CORRECT, 

expanded weekly MA can be matched against daily close 

EXAMPLE 2: 

Incorrect code: 

TimeFrameSet ( inWeekly ) ; 

MA14_Weekly = MA ( Close, 14 ); 

TimeFrameRestore () ; 

Buy = Cross ( Close, TimeFrameExpand ( MA14_Weekly, inDaily ) ); // WRONG 

It’s always necessary to Indicate In TlmeFrameExpand() function, which timeframe was variable calculated 
In. So If MA14_Weekly was calculated In out of weekly data, inWeekiy should be the correct parameter of 
TlmeFrameExpand() function. 
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Correct code: 

TimeFrameSet ( inWeekly ) ; 

MA14_Weekly = MA ( Close, 14 ); 

TimeFrameRestore () ; 

Buy = Cross ( Close, TimeFrameExpand ( MA14_Week:ly, inWeekly ) ) ; // CORRECT 
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Porfolio Backtester Interface Reference Guide 

(Updated February 20th, 2010 to cover enhancements and additions introduced in AmiBroker 5.30.0) 
Basics 

AmiBroker version 4.67.0 exposes new object-oriented interface to porfolio backtester allowing to control 2nd 
phase of the backtest. This allows multitude of applications including, but not limited to: 

• position sizing based on portfolio-level equity 

• implementing advanced rotational systems (you have now access to ranking arrays and can decide 
what trades to take after knowing which symbols scores best on bar-by-bar basis) 

• adding your custom metrics to backtest and optimization statistics 

• implementing custom formulas for slippage control 

• advanced scaling-in/-out based on portfolio equity and other run-time stats 

• advanded trading systems that use portfolio-level statistics evaluated on bar-by-bar basis to decide 
which trades to take 

This document describes all objects, methods and properties exposed by portfolio interface. 

Requirements 

To use new interface the user needs AmiBroker 4.67.0 or higher and needs to have AFL coding skills 
including understanding the terms: an object, method and property. 

Various approaches for various appiications 

The porfolio backtester interface supports various approaches to customization of backtest process that suit 
different applications. 

• high-ievei approach (the easiest) 

- using BacktestO method and it runs default backtest procedure (as in old versions) - allows simple 
implementation of custom metrics 

• mid-ievei approach 

- using PreProcess()/ProcessTradeSignal()/PostProcess() methods - allows to modify signals, query 
open positions (good for advanced position sizing) 

• iow-ievei approach (the most compiex) 

- using 

PreProcess()/EnterTrade()/ExitTrade()/ScaleTrade()/UpdateStats()/HandleStops()/PostProcess() 
methods - provides full control over entire backtest process for hard-code programmers only 

Getting access to the interface 

To access new portfolio backtester interface you need to: 

• enable custom backtesting procedure by calling: 

SetOption ( "UseCustomBacktestProc" , True ); 

or calling 
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SetCustomBacktestProc ( "C:\\MyPath\\MyCustoinBacktest.af1" ); 

in your formula 

or by enabling it in Automatic Analysis->Settings window, "Portfolio" tab and specifying external 
custom procedure file. 

• get access to backtester object by calling GetBacktesterObject() method. Note that GetBacktester 
method should only be called when Status("action") returns actionPortfolio: 

if ( Status ( "action" )== actionPortfolio ) 

{ 

// retrieve the interface to portfolio backtester 
bo = GetBacktesterObject (); 

...here is your custom backtest formula. 

} 


When using external custom procedure file you don't need to check for actionPortfolio, because 
external backtest procedures are called exclusively in actionPortfolio mode. 

Typing Conventions 

• bool - italic represents the type of parameter/variable/return value (Trade, Signal, Stats - represent the 
type of object returned) 

• AddSymbois - bold represents function / method / property name 

• SvmbolList - underline type face represents formal parameter 

• [optional] - denotes optional parameter (that does not need to be supplied) 

• variant - represent variable type that can be either string or a number 

Despite the fact that interface handles integer data type such as long, short, bool and two different floating 
point types: float and double, the AFL itself converts all those data types to float because AFL treats all 
numbers as floats (32-bit IEEE floating point numbers). 

Objects 

The interface exposes the following objects: 

• Backtester object 

• Signal object 

• Trade object 

• Stats object 

The only object directly accessible from AFL is Backtester object, all other objects are accessible by calling 
Backtester object methods as shown in the picture below. 
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Backtester object 

Backtester object allows to control backtest process (process signals, enter/exIt/scale trades) and get access 
to signal list, open position and trade list and to performance statistics object. 

Methods: 

• boo/ AddCustomMetric( string Title, variant Value, [optional] variant LonoOnlvValue. [optional] 
variant ShortOnIvValue , [optional] variant DecPIaces = 2, [optional] variant ComblneMethod = 2 ) 

This method adds custom metric to the backtest report, backtest "summary" and optimization result 
list. Title Is a name of the metric to be displayed In the report. Value Is the value of the metric, optional 
arguments LongOnlyValue, ShortOnlyValue allow to provide values for additional long/short-only 
columns In the backtest report. DecPIaces argument controls how many decimal places should be 
used to display the value. The last ComblneMethod argument defines how custom metrics are 
combined for walk-forward out-of-sample summary report 

Supported ComblneMethod values are: 

1 first step value, - summary report will show the value of custom metric from very first out-of-sample 
step 

2 last step value (default), - summary report will show the value of custom metric from the last 
out-of-sample step 

3 sum, - summary report will show the sum of the values of custom metric from all out of sample steps 

4 average, - summary report will show the average of the values of custom metric from all out of 
sample steps 

5 minimum, - summary report will show the smallest value of custom metric from all out of sample 
steps 

6 maximum.- summary report will show the largest value of custom metric from all out of sample steps 

Note that certain metrics calculation methods are complex and for example averaging them would not 
lead to mathematically correct representation of all out of sample test. 

Summaries of all bullt-ln metrics are mathematically correct out-of-the-box (I.e. they are *not* 
averages, but properly calculated metrics using method that Is appropriate for given value). This 
contrasts with custom metrics, because they are user-definable and It Is up to the user to select 
'combining' method, and still It may happen that none of the available methods Is appropriate. 

For that reason the report Includes the note that explains what user-definable method was used to 
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combine custom metrics. 


• bool Backtest( [optional] bool NoTradeList ) 

This high-ievei method performs defauit portfoiio backtest procedure in singie caii. It shouid be used if 
you just need to obtain custom metrics and do not want to change the way backtest is performed. 
(Version 4.68.0 and above): If optional parameter NoTradeList is set to True, then trade list is not 
generated automatically. This is useful if you want to add some per-trade metrics. Once you add 
them, you can generate trade list with your metrics using ListTrades method. 

• long EnterTrade( Iona Bar, string Symbol . boo/ bLona . float Price , float PosSize . [optional] variant 
PosScore . [optional] variant RoundLotSize . [optional] variant MarainPeposit . [optional] variant 
TickSize . [optional] variant PointValue ) 

Low-level method that enters trade on any symbol. This allows to take trades even on symbols that 
have no corresponding signals. If values for optional parameters are not provided then AmiBroker 
uses values defined in Symbol->lnformation window 

• tong ExitTrade( Iona Bar, string Symbol , float Price , [optional] variant ExitTvoe ) 

Low-level method that exits trade on any symbol. This method searches open trade list and if there is 
no open trade on given symbol it does nothing. Optional ExitType parameter specifies the reason for 
exit (1 - regular exit, 2 - max. loss, 3 - profit, 4 - trail, 5 - N-bar, 6 - ruin) 

• Trade FindOpenPos( string Symbol ) 

This method looks for the Symbol in open position list and returns matching trade object if it finds one 
or returns null object otherwise. 

• S/gna/ FindSignal( long Bar, string Symbol , long Type ) - new in v5.10 


where bar is a bar number, type represents type of signal to find: 0 - both entries and exits, 1 - only 
entries, 2 - only exits 

The method finds for first matching signal that has fPrice != -1 (different than -1). If 0 is used as type, 
and entry and exit is on the same bar then entry signal will be returned. Note: fPrice = -1 is a special 
marker meaning that given signal should be ignored. 

• long GetSignalQty( long Bar,long Type ) - new in v5.30 


where bar is a bar number, symbol is ticker symbol, type represents type of signal to find: 0 - both 
entries and exits, 1 - only entries, 2 - only exits 

The method retrieves the number of signals occuring on given bar. Note that AmiBroker to conserve 
memory keeps track only of 2 * MaxNumberOfPositions entry signals on any single bar, however it 
keeps track of ALL exit signals (because they consume much less space and at the time of signal 
collection it is not known which positions are already open, so all exits must be tracked to prevent 
missing an exit) 
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• Trade GetFirstOpenPos() 

This method returns first Trade object from open position iist 

• Signal GetFirstSignal( long Bar) 

This method returns first trading S/gna/object for given Bar 

• Trade GetFirstTradeQ 

This method returns first Trade object from ciosed trade iist 

• Trade GetNextOpenPos() 

This method returns next Trade object from open positions iist. You shouid caii GetFirstOpenPos 
before caiiing this method for the first time. Returns nuii object when no more open positions are 
found. 

• Signal GetNextSignal( long Bar) 

This method returns next Signal object from ciosed signai iist of given Bar . You shouid caii 
GetFirstSignai before caiiing this method for the first time. Returns nuii object when no more signais 
are found. 

• Trade GetNextTradeO 

This method returns next Trade object from ciosed trade iist. You shouid caii GetFirstTrade before 
caiiing this method for the first time. Returns nuii object when no more trades are found. 


• long GetOpenPosQtyO 

This method returns number of currentiy open positions 

• Stats GetPerformanceStats( long Type ) 

Caicuiates buiit-in statistics and metrics and returns Stats object. Tvoe parameter specifies what 
trades shouid be counted in. Type = 0 means aii trades, Type = 1 means iong-oniy, Type = 2 means 
short-oniy. 

• HandleStops( Iona Bar ) 

This iow-ievei method handies automatic stops (appiystops). This method MUST NOT be used in 
high-level and mid-level approaches. In low-level mode you should call this method once for each 
bar inside trading loop. 

• ListTradesO 

(Version 4.68.0 and above) This outputs trades to the result list of Automatic Analysis window. 
Usually this function does NOT need to be called because Backtest() method by default lists trades 
already. This function should only be used when you disabled trade listing in Backtest method to add 
some custom per-trade metrics. 
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• PostProcessO 

This mid-level and low-level method performs final processing required to complete backtest correctly. 
Among other things it frees price cache, closes out any open trades and outputs trade list to the 
Automatic Analysis window. It should NOT be used when you call Backtest() method because 
BacktestO already performs necessary processing. 

• PreProcessO 

This mid-level and low-level method performs initial processing required to perform backtest correctly. 
Among other things it initializes price cache and sets up initial variables. It should NOT be used when 
you call BacktestO method because Backtest() already performs necessary processing. 

• bool ProcessTradeSignals( Iona Bar ) 

This mid-level method processes all trading signals for given bar. It should be called once per every 
bar in your custom backtesting loop. 

• RawTextOutput( string Text ) 

(Version 4.68.0 and above) This method outputs any string to the Automatic Analysis result list at the 
time of the call. The user can output text formatted in multiple columns using \t (tab) character. 

• Iona ScaleTradef tong Bar, string Symbol , boo/ bincrease . float Price , float PosSize . [optional] variant 
Deposit) 

Low-level method that scales trade on any symbol. This method searches open trade list and if there 
is no open trade on given symbol it does nothing. Optional Deposit parameter specifies margin 
deposit for futures, if not given then Price parameter is used. 

• UpdateStats( long Bar, long TimelnsideBar ) 

Low-level method that updates equity, exposure, trade excursions (for MAE/MFE calculations) and 
other internal variables required for correct calculation of statistics. You must NOT use this function 
in high-ievei and mid-ievei approaches. TimelnsideBar parameter specifies intraday time position. 
TimelnsideBar = 0 means opening of the bar, TimelnsideBar = 1 means middle of the bar, 
TimelnsideBar = 2 means end of bar. As certain internal calculations depend on end-of-bar 
calculations, this method must be called once and only once with TimelnsideBar parameter set to 2 at 
the end of processing of every bar inside in your custom backtesting loop. May be called zero or more 
times for every bar inside backtesting loop with TimelnsideBar parameter set to 0 (zero) or 1. 

• GetMonteCarloSimQ 

get the instance of MonteCarloSim object to access MC distributions 
Properties: 

• double Cash 

available funds (cash) in your portfolio 
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• double Equity 

current portfolio-level Equity (read-only property) 

• array EquityArray 

portfolio-level Equity array (read-only property) 

Note: Since version 5.50 backtester object now has EquityArray property that returns entire equity 
array (not just current value). Please note that values are filled during backtest and only after backtest 
is complete, all values are valid. If you call it in the middle, it will contain only "upto given point" data. 
Avoid abusing this function and it is costly in terms of RAM/CPU.e). You may use bo.EquityArray 
instead of Foreign("—Equity", "C") in custom backtester code. 

• double InitialEquity 

funds that are available at the beginning of the backtest 

• double MarginLoan 

loan amount (only if you are using margin account) (read-only property) 

Signal object 

Signal object represents trading signal (buy/sell/short/cover) or ranking array element generated by AmiBroker 
during first phase of backtest when your formula is executed on every symbol under test. During this first 
phase scan AmiBroker collects data from buy/sell/short/cover signal, price, position size and score arrays, 
performs sorting of signals and put top-ranked entry signals and all scale and exit signals into the list. 

Separate list of trading signals is maintaned for every bar. Signal list is sorted so first entry signals appear (top 
ranked first) and after that scaling and exit signals follow. To conserve memory AmiBroker stores only 
(2*MaxOpenPositons) top-ranked entry signals per bar. It keeps however all exit and scaling signals. Once 
first phase is completed and backtester enters 2nd phase (real backtest) it iterates through bars and through 
all signals within given bar and executes trades based on this signals. 

To iterate through signal list you should use GetFirstSignal() / GetNextSignal() methods of Backtester object, 
as shown below: 

// retrieve the interface to portfolio backtester 
bo = GetBacktesterObject () ; 

for ( sig = bo.GetFirstSignal(); sig; sig = bo.GetNextSignal() ) 

{ 

if ( sig.IsEntry() ) 

{ 

// handle entry signal 

} 

} 

Methods: 

• bool IsEntryO 
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True if this is entry signai, Faise otherwise 

• bool IsExitO 

True if this is exit signai, Faise otherwise 

• bool IsLongO 

True if this is iong entry (buy) or iong exit (seii) or scaie-in signai, Faise otherwise 

• bool IsScaleO 

True if this is scaie-in or scaie-out signai, Faise otherwise 
Properties: 

• //oaf MarginDeposit 

margin deposit (for futures) 

• f/oaf PointValue 

point vaiue (for futures, currencies) 

• float PosScore 
position score 

• float PosSize 

requested position size (positive numbers mean doiiar vaiue, negative vaiues mean percent of 
portfoiio equity) 

• float Price 
entry/exit/scaie price 

• short Int Reason 

this specifies reason of exit ( 0 - reguiar exit, 1 - max. ioss, 2 - profit, 3 - traii, 4 - N-bar, 5 - ruin ) 

• f/oaf RoundLotSize 
round iot size 

• string Symbol 
symboi of security 

• f/oaf TickSize 

tick size (minimum price change) 
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• short intJype 

this specifies signai type ( 0 - rank (rotationai systems oniy), 1 - buy, 2 - seii, 3 - short, 4 - cover, 5 - 
scaie-in, 6 - scaie-out) 


Trade object 

Trade object represents either currentiy open position (open trade) or ciosed trade. AmiBroker maintains 2 
iists of trades: open position iist (accessibie using GetFirstOpenPos/GetNextOpenPos methods of backtester 
object) and ciosed trade iists (accessibie using GetFirstTrade/GetNextTrade methods of the backtester 
objects). Once open position is ciosed by the backtester it is automaticaiiy moved from open position iist to 
trade iist. When backtest is compieted (after PostProcess caii) AmiBroker cioses out aii open positions, so 
trade iist inciudes aii trades. You can access both iists any time during backtest, you can aiso access trade iist 
after compietion to generate trade-reiated stats. 

To iterate through open position iist you shouid use GetFirstOpenPosQ / GetNextOpenPosQ methods of 
Backtester object, as shown beiow: 

// 'bo' variable holds Backtester object retrieved earlier 

for ( openpos = bo.GetFirstOpenPos(); openpos; openpos = bo.GetNextOpenPos() ) 

{ 

// openpos variable now holds Trade object 

} 

To iterate through ciosed trade iist you shouid use GetFirstTrade() / GetNextTrade() methods of Backtester 
object, as shown beiow: 

for ( trade = bo.GetFirstTrade(); trade; trade = bo.GetNextTrade() ) 

{ 

// trade variable now holds Trade object 

} 

Methods: 

• long AddCustomMetricf string Titie. variant Vaiue. [optional] decpiaces = 2) 

(Version 4.68.0 BETA and above) This method adds PER-TRADE custom metric to the trade iist oniy. 
Titie is a name of the metric to be dispiayed in the report, Vaiue is the vaiue of the metric. When using 
this function you have to ensure that you the same metrics in the same order to every trade. 

Otherwise output may be messed up. Note that in contrast to Backtester.AddCustomMetric method 
that is usuaiiy caiied after PostProcess, the Trade.AddCustomMetric shouid be caiied before 
PostProcess caii because PostProcess iists trades. Using Trade.AddCustomMetric after 
PostProcess gives no resuit, because trades are aiready iisted. Aiso if you are using 
Backtester.BacktestO method you shouid caii it with NoTradeList parameter set to True, add your 
per-trade metrics and then caii ListTrades to aiiow your custom metrics to be inciuded in the output. 
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• //oaf GetCommission( foDtionall bool InclExit ^ 

retrieves commission paid for that trade (inciudes aii scaie in/out commissions). Depending on InciExit 
parameter the function returns commission inciuding (True, defauit) or exiuding (Raise) exit 
commission. 

• double GetEntryValueO 

retrieves doiiar entry vaiue of the trade 

• f/oaf GetMAEO 

retrieves trade's Maximum Adverse Excursion in percent 

• f/oaf GetMFEO 

retrieves trade's Maximum Favorabie Excursion in percent 

• double GetPercentProfitO 

retrieves current percent profit of the trade 

• double GetPositionValue() 

retrieves current doiiar value of the position. 

• float GetPrice( long Bar, string Field ) 

(Version 4.68.0 BETA and above) provides quick access to price arrays of open positions. Bar 
parameter represents the data bar to query price for, Field parameter specifies which price field you 
want to get, allowable values are: 

"O" (Open) 

"H" (High) 

"L" (Low) 

"C" (Close) 

"F" (Fx currency rate) 

NOTES: 

1. GetPrice method is available for OPEN POSITIONS only, when called on closed trade returns Null 
value 

2. Open Interest field is NOT available via GetPrice 

3. Bar must be between O..BarCount-1, otherwise exception will occur 


• double GetProfitO 

retrieves current dollar (point) profit of the trade 


Properties: 
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• long BarsInTrade 

bars spent in trade (counting starts from 0) 

Note however that the vaiue of zero is avaiiabie oniy when trade is just opened in "iow-ievei" 
approach, so normaiiy you wouid see numbers >= 1 (aii other reporting in AB remains as it was, so 
enter today and exit tommorrow counts as 2-bar trade) 

• float EntryDateTime 

entry date/time in internai AmiBroker format (the same as used by AFL function DateTimeQ) 

• float EntryFxRate 

entry foreign exchange currency rate, if any scaiing-in occurred this hoids average entry fx rate 

• float EntryPrice 

entry price, if any scaiing-in occurred this hoids average entry price 

• float ExitDateTime 

exit date/time in internai AmiBroker format (the same as used by AFL function DateTime()) 

• float ExitFxRate 

exit foreign exchange currency rate, if any scaiing-out occurred this hoids average exit fx rate 

• float ExitPrice 

exit price, if any scaiing-out occurred this hoids average exit price 

• double Handle 

internai handie vaiue that aiiows to uniqueiy identify and manage (for exampie exit or scaie in/out) 
muitipie trades open on the same symboi at the same time. It can be passed to ExitTrade / 
ScaieTrade instead of the symboi. 

• bool IsLong 

True if trade is iong, Faise otherwise 

• bool IsOpen 

True if trade is open, Faise otherwise 

• //oaf MarginDeposit 
initiai margin deposit 

• double MarginLoan 

ioan amount used for this trade 
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• //oaf PointValue 

point value (for futures / currencies) 

• f/oaf Round LotSize 
round lot size 

• float Score 
entry score 

• f/oaf Shares 

number of shares / contracts 

• string Symbol 
symbol of the security 

• string FullName 

full name of the instrument (added in 5.69) 

• f/oaf TickSize 

tick size (minimum price change) 

Stats object 

Stats object provides the access to built-in backtester statistics and metrics. Metrics are usually calculated 
once backtest is completed but it is also possible to calculate metrics during backtest. To calculate current 
metrics and get the access to them simply call GetPerformanceStats method of Backtester object. Please 
note that if you calculate statistics in the middle of the backtest they will include only closed trades. 

To calculate and access stats use the following code: 

// 'bo' variable holds Backtester object retrieved earlier 
stats = bo.GetPerformanceStats( 0 ) ; 

Methods: 

• double GetValue( string MetricName ) 

retrieves the value of a metric, MetricName can be one of the following: 
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"NetProfitPercent" 

"ExposurePercent" 


M 


M 


NetRAR 

CAR" 

RAR" 


ft 


"AIIQty" 

"All Percent" 

"AIIAvgProfItLoss" 

"AIIAvgProfItLossPercent" 

"AIIAvgBarsHeld" 

"WInnersQty" 

"WInnersPercent" 

"WInnersTotal Profit" 

"WInnersAvgProfIt" 

"WInnersAvgProfItPercent" 

"WInnersAvgBarsHeld" 

"WInnersMaxConsecutIve" 

"WInnersLargestWIn" 

"WInnersLargestWInBars" 

"LosersQty" 

"LosersPercent" 

"LosersTotalLoss" 

"LosersAvgLoss" 

"LosersAvgLossPercent" 

"LosersAvgBarsHeld", 

"LosersMaxConsecutIve" 

"LosersLargestLoss" 

"LosersLargestLossBars" 

"MaxTradeDrawdown" 
"MaxTradeDrawdown Percent" 
"MaxSystem Drawdown" 
"MaxSystemDrawdownPercent" 
"RecoveryFactor" 

"CAR/MDD" 

"RAR/MDD" 

"ProfItFactor" 

"PayoffRatIo" 

"StandardError" 

"RRR" 

"UlcerIndex" 

"UlcerPerformanceIndex" 

"SharpeRatIo" 

"KRatIo" 

Properties: 


-none- 
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MonteCarloSim object 

The object allows to access MonteCarlo simulation results and has only one method 
Methods: 

• GetValue( sfr/ng "field", float percentile ) 

retrieves "field" value at specified percentile level. Available fields: "FInalEquIty", "CAR", 
"LowestEquIty", "MaxDrawdown", "MaxPercDrawdown" 

Further information 

Examples and more documentation can be found in this Houston presentation covering custom backtester interface (300 KB PDF 
format) and the Knowledge Base: http://www.amlbroker.com/kb/category/afl/custom-backtest/ 
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How to add user-defined metrics to backtest/optimization report 

One of the new additions in 4.67.x/4.68.x BETA is portfoiio backtester programming interface providing full control of 2nd phase of 
portfolio backtest. This allows multitude of applications including, but not limited to: 

• user-defined metrics (appear as an additional column in "summary" backtest result list, in optimization 
result and as a new row in backtest report "statistics" page, as well as per-trade metrics) 

• access to portfolio-level equity when backtest loop is run - allows for example complext position sizing 
based on portfolio equity 

• read/write access to portfolio cash - allows adding funds to portfolio 

• read/write access on bar-by-bar basis to trading signals generated in 1st backtest phase allows 
reading ranking array and modifying signal price (for example custom slippage formulas), position 
size, etc 

• access to list of currently open positions, each position can be queried for various properties including 
profit, MAE/MFE, bars in trade, etc 

• access to list of closed trades, each closed trade can be queried for various properties including 
profit,MAE/MFE, bars in trade, etc 

• three different levels of programming: 

♦ high-level - using Backtest() method and it runs default backtest procedure (as in old 
versions) - great for adding custom metrics 

♦ mid-level - using PreProcess()/ProcessTradeSignal()/PostProcess() methods - allows to 
modify signals, query open positions (good for advanced position sizing) 

♦ low-level - using 

PreProcess()/EnterTrade()/ExitTrade()/ScaleTrade()/UpdateStats()/HandleStops()/PostProcess() 
methods provides full control over backtest process for hard-code programmers 

Technical reference of new interface is available here, in this chapter we will just focus on some practical 
examples. 

Adding user-defined metrics 

Example 1 

Let's start with the easiest application: in the very first example I will show you how to add user-defined metric 
to portfolio report and optimization result list. 

In the first step we will add Expectancy to backtest and optimization report. There is some discussion about 
how expectancy should be calculated but the easiest formula for it is: 

Expectancy ($) = %Winners * AvgProfit - %Losers * AvgLoss 

or (the other way of calculating the same) 

Expectancy ($) = (TotalProfit - TotalLoss) / NumberOfTrades = NetProfit / NumberOfTrades 

Let us start with this simple formulation. With this approach expectancy simply tells us expected profit per 
trade in dollars. The custom backtest formula that implements this user-defined metric looks as follows: 

/* First we need to enable custom backtest procedure and 
** tell AmiBroker to use current formula 
*/ 
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SetCustomBacktestProc ( "" ) ; 

/* Now custom-backtest procedure follows */ 

if ( Status ( "action" ) == actionPortfolio ) 

{ 

bo = GetBacktesterObjectO; 

bo.Backtest 0; // run default backtest procedure 

St = bo.GetPerformanceStats( 0 ); // get stats for all trades 

// Expectancy calculation (the easy way) 

// %Win * AvgProfit - %Los * AvgLos 

// note that because AvgLos is already negative 

// in AmiBroker so we are adding values instead of subtracting them 
// we could also use simpler formula NetProfit/NumberOfTrades 
// but for the purpose of illustration we are using more complex one :-) 
expectancy = 

St.GetValue( "WinnersAvgProfit" )*st.GetValue( "WinnersPercent" )/ 100 + 

St.GetValue( "LosersAvgLoss" )*st.GetValue( "LosersPercent" )/ 100 ; 

// Here we add custom metric to backtest report 
bo.AddCustomMetric( "Expectancy ($)", expectancy ); 

} 

// your trading system here 

fast = Optimize ( "fast" , 12, 5, 20, 1 ) ; 

slow = Optimize ( "slow" , 26, 10, 25, 1 ); 

Buy=Cross (MACD (fast,slow), Signal (fast,slow)) ; 

Sell=Cross (Signal (fast,slow), MACD (fast,slow)) ; 

First we need to tell AmiBroker to use custom backtest formula instead of built-in one. We are doing so by 
calling SetCustomBacktestProc. First parameter defines the path to the custom backtest formula (which can 
be stored in some external file, independent from actual trading system). If we provide empty string there, we 
are telling AmiBroker to use current formula (the same which is used for trading system). 

In the next line we have "if" statement that enters custom backtest formula if the analysis engine is in 
actionPortfolio (2nd phase of portfolio backtest) stage. This is important as formula is executed in both 
scanning phase (when trading signals are generated) and in actual portfolio backtest phase, "if" statement 
allows us to enter custom backtest procedure part only when analysis engine is in actual backtesting phase. 

In the next line we obtain the access to backtester programming interface by calling GetBacktesterObject 
function. This returns Backtester object that is used to access all functionality of new interface (more details 
on objects available see: http://www.amibroker.com/docs/ab401.html) 

Later we obtain access to built-in metrics by calling GetPerformanceStats method of backtester object. This 
method returns Statistics object that allows us to access any built-in metric by calling GetValue method. 

As a next step we calculate expectancy value from built-in metrics retrieved using GetValue method. For the 
list of metrics supported by GetValue method please check: http://www.amibroker.com/docs/ab401 .html 
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In the final step we simply add our custom metric to the report by calling AddCustomMetric function of 
Backtester object. The first parameter is the name of the metric, the second is the value. 


After "if'-statement implementing our custom backtest procedure usual trading system rules follow. 


Now when you run Backtest and click Report button in Automatic Analysis window you will see your custom 
metric added at the bottom of statistics page: 



User-defined metric also appears in the Optimization result list: 



When you click on the custom metric column, the optimization results will be sorted by your own metric and 
you will be able to display 3D chart of your user-defined metric plotted against optimization variables. 




Portfolio Optimization (default) 


View 3D optimization graph 


Old (v4.4) Optimizer 
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Example 2 

Some people point out that this simple method of calculating expectancy works well only with constant 
position size. Otherwise, with variable position sizing and/or compounding, larger trades weight more than 
smaller trades and this leads to misleading expectancy values. To address this problem one could calculate 
expectancy for example as expected profit per $100 invested. To do calculate such statistic, one needs to 
iterate through trades, summing up profits per $100 unit, and dividing this sum by the number of trades. 
Appropriate formula follows: 

/* First we need to enable custom backtest procedure and 
** tell AmiBroker to use current formula 
*/ 


SetCustomBacktestProc ( "" ) ; 

/* Now custom-backtest procedure follows */ 

if ( Status ( "action" ) == actionPortfolio ) 

{ 

bo = GetBacktesterObjectO; 

bo.Backtest 0; // run default backtest procedure 
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SumProfitPerl00Inv = 0; 

NumTrades = 0; 

// iterate through closed trades first 

for ( trade = bo.GetFirstTrade(); trade; trade = bo.GetNextTrade() ) 

{ 

// here we sum up profit per $100 invested 

SumProfitPerl00Inv = SumProfitPerl00Inv + trade.GetPercentProfit(); 
NumTrades++; 

} 

// iterate through eventually still open positions 

for ( trade = bo.GetFirstOpenPos() ; trade; trade = bo.GetNextOpenPos() ) 

{ 

SumProfitPerl00Inv = SumProfitPerl00Inv + trade.GetPercentProfit(); 
NumTrades++; 

} 

expectancy2 = SumProfitPerl00Inv / NumTrades; 
bo.AddCustomMetric( "Expectancy (per $100 inv.)"; expectancy2 ); 


} 

// your trading system here 

fast = Optimize ( "fast" , 12, 5, 20, 1 ); 

slow = Optimize ( "slow" , 26, 10, 25, 1 ); 

Buy=Cross (MACD (fast,slow), Signal (fast, slow)) ; 

Sell=Cross (Signal (fast,slow), MACD (fast,slow)) ; 

The only difference between this and previous formula is that we do not use built-in metrics to calculate our 
own expectancy figure. Instead we sum up all percentage profits of each trade (which are equivalent to dollar 
profits from $100 unit investment) and at the end divide the sum by the number of trades. Summing up is 
done inside the "for" loop. GetFirstTrade/GetNextTrade function pair of the backtester object allows us to step 
through the list of closed trades. We use two loops (second loop uses GetFirstOpenPos/GetNexOpenPos) 
because there may be some open positions left at the end of the backtest. If we wanted to include only closed 
trades then we could remove second "for" loop. 

After running this code we find out that expectancy calculated this way even adjusted to initial equity (by 
multiplying by factor lnitialEquity/$100) is smaller than expectancy calculated in the first example. This shows 
that "easy" method of expectancy calculation (from example 1) may lead to overly optimistic results. 

Example 3 

Some Van Tharp followers prefer yet slightly differnt "twist" of expectancy measure. They express expectancy 
in terms of expected profit per "unit of risk". The profit is then expressed in terms of R-multiples, where 1R is 
defined as the amount risked per trade. The amount risked is the maximum amount of money you can lose, 
and most often it is set by the amount of maximum loss stop (or trailing stop). According to Tharp, the easiest 
way to calculate expectancy is simply to add up all your R-multiples and net them out by subtracting the 
negative R-multiples from the positive ones, then divide by the no. of trades. This gives you your expectancy 
per trade. 
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This is very simiiar to approach presented in exampie 2, but for the caicuiations we do not use the vaiue of the 
trade but rather risk per trade. The risk depends on the stop we use in our trading system. For simpiicity in this 
exampie we have used 10% max. ioss stop, in this exampie we aiso add per-trade metrics for better 
iiiustration of how R-muitipies are caicuiated. Per-trade metrics appear in each row of the trade iist in the 
backtest resuits. 



The formuia that impiements this kind of expectancy measure foiiows: 


/* First we need to enable custom backtest procedure and 
** tell AmiBroker to use current formula 
*/ 


SetCustomBacktestProc ( "" ) ; 

MaxLossPercentStop = 10; // 10% max. loss stop 

/* Now custom-backtest procedure follows */ 
if ( Status ( "action" ) == actionPortfolio ) 

{ 

bo = GetBacktesterObjectO; 

bo.Backtest( 1 ); // run default backtest procedure 

SumProfItPerRlsk = 0; 

NumTrades = 0; 

// iterate through closed trades first 

for ( trade = bo.GetFirstTrade() ; trade; trade = bo.GetNextTrade() ) 

{ 

// risk is calculated as the maximum value we can loose per trade 
// in this example we are using max. loss stop 
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// it means we can not lose more than (MaxLoss%) of invested amount 
// hence ris 

Risk = ( MaxLossPercentStop / 100 ) * trade.GetEntryValue(); 

RMultiple = trade.GetProfit()/Risk; 

trade.AddCustomMetric (" Initial risk Risk ); 

trade.AddCustomMetric( "R-Multiple" , RMultiple ); 

SumProfitPerRisk = SumProfitPerRisk + RMultiple; 

NumTrades++; 


expectancyS = SumProfitPerRisk / NumTrades; 

bo.AddCustomMetric( "Expectancy (per risk)", expectancyS ) ; 
bo.ListTrades(); 


} 

// your trading system here 

ApplyStop ( stopTypeLoss, stopModePercent, MaxLossPercentStop ); 

fast = Optimize ( "fast" , 12, 5, 20, 1 ) ; 
slow = Optimize ( "slow" , 26, 10, 25, 1 ); 

Buy=Cross (MACD (fast,slow), Signal (fast, slow)) ; 

Sell=Cross (Signal (fast,slow), MACD (fast,slow)) ; 

The code is basically very similar to example 2. There are only few differences. First is that we call Backtest 
method with NoTradeList parameter set to 1. This way we disable default trade listing, so we can add custom 
per-trade metrics and list trades later by calling ListTrades method. Later we iterate through trades and 
calculate risk based on trade entry value and amount of max. loss stop used. The RMultiple is then calculated 
as trade profit divided by the amount risked per trade. Both risk and r-multiple are then added as custom 
per-trade metrics (note that we are callind AddCustomMetric method of Trade object here). Later on we do 
remaining calculations. At the end of the custom backtest procedure we are adding custom backtest metric 
(this time calling AddCustomMetric method of Backtester object), and after that we trigger listing of the trades 
using ListTrades method. For simplicity we ignore any open positions that may have left at the end of analysis 
period. The only change to the trading system itself was addition of maximum loss stop (ApplyStop line). 

Conclusion 

A new portfolio backtester programming interface provides ability to add user-defined statistics of any kind, 
allowing the user to move the analysis of backtesting results to completely new level. 
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Using low-level graphics functions 

Completely new low-level graphic AFL Interface allows complete flexibility In creating any kind of user-defined 
display. 

The Interface mimics closely Windows GDI API, with same names for most functions for easier use for 
GDI-experienced programmers. The only differences are: 

1. compared to Windows GDI all functions are prefixed with 'Gfx' 

2. pen/brush/font creatlon/selectlon Is simplified to make It easier to use and you don't need to care about 
deletion of GDI objects 

3. three overlay modes are available so you can mix low-level graphics with regular PlotQ statements 
(mode = 0 (default) - overlay low-level graphic on top of charts, mode = 1 - overlay charts on top of low-level 
graphic, mode =2 - draw only low-level graphic (no regular charts/grid/titles/etc)) 

All functions use PIXELS as co-ordinates (when used on screen). For printouts and metafiles pixels are 
mapped to logical units to match higher resolution of printers. Use Status("pxwldth") and Status("pxhelght") to 
find pixel dimensions of drawing surface. 


Available low-level gfx functions (click on the links for detailed explanation): 

GfxMoveTo( x, y) 

GfxLineTo( x, y) 

GfxSetPixel( x, y, color) 

GfxTextOut( "text", x, y ) 

GfxSelectPen( color, width = 1, penstyle = penSolld ) 

GfxSelectSolidBrush( color) 

GfxSelectFont( "facename", pointsize, weight = fontNormal, Italic = False, underline = False, orientation = 0 ) 
GfxRectangle( x1, y1, x2, y2 ) 

GfxRoundRect( x1, y1, x2, y2, x3, y3 ) 

GfxPie( x1, y1, x2, y2, x3, y3, x4, y4 ) 

GfxEllipse( x1, y1, x2, y2 ) 

GfxCircle( x, y, radius ) 

GfxChord( x1, y1, x2, y2, x3, y3, x4, y4 ) 

GfxArc( x1, y1, x2, y2, x3, y3, x4, y4 ) 

GfxPolygon( x1, y1, x2, y2,...) 

GfxPolyline( x1, y1, x2, y2,...) 

GfxSetTextColor( color) 

GfxSetTextAlign( align ) 

GfxSetBkColor( color) 

GfxSetBkMode( bkmode) 

GfxGradientRect( x1, y1, x2, y2, fromcolor, tocolor) 

GfxDrawText( "text", left, top, right, bottom, format = 0 ) 

GfxSetOverlayMode( mode = 0 ) 

NEW FUNCTIONS IN 5.80 

GfxSetCoordsMode( mode ) - allows to choose between pixel and bar/price mode. 

GfxSetZOrder( layer) - allows to place Gfx graphics on user-specified Z-axIs (depth) layer 
GfxGetTextWidth( "text") - returns pixel width of specified string. NOTE: It Is slow because It has to create 
temporary DC and font to measure the text. It takes 40us (microseconds), that Is about 40 times more than 
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other Gfx functions. 

CO-ORDINATE MODES 

Starting with version 5.80 AmiBroker supports using two different co-ordinate modes in low-level graphics: 
pixel mode and bar/price mode. 

GfxSetCoords mode function allows to switch co-ordinate system for low-level gfx functions from sceen pixel 
(mode = 0) - the default, to 

bar / price mode (mode = 1 ) where X is expressed in bar index and Y is expressed in price. 

This new mode allows way easier overlays on top of existing charts without need to do conversion between 
bars/price pixels 

and without any extra refresh normally required in old versions when Y scale changed. 

The function can be called to switch back and forth from pixel -> bar/price mode and vice versa a number of 
times 

allowing to mix different modes in the same chart. 

When co-ordinate mode 1 is selected (bar/price), co-ordinates can be fractional. For example if x is 2.5 it 
means half way between bar 2 and 3. 

Example; 

// The sample shows how using GfxSetCoordsMode( 1 ) 

// results in 

// a) easier coding of overlay charts that plot on top of built-in charts (no 
need to convert from bar/price to pixels) 

// b) perfect matching between built-in Plot() and Gfx positioning 
Plot ( C, "Price", colorDefault, styleLine ); 

GfxSetOverlayMode ( 1 ) ; 

GfxSetCoordsMode ( 1 ); // bar/price mode (instead of pixel) 

GfxSelectSolidBrush ( colorRed ); 

GfxSelectPen ( colorRed ) ; 

boxheight = 0.01 * ( HighestVisibleValue ( C ) - LowestVisibleValue ( C ) ); 

bi = BarIndexO; 

start = FirstVisibleValue ( bi ) ; 
end = LastVisibleValue ( bi ) ; 

for ( i = start; i <= end; i++ ) 

{ 

Cl = Close [ i ]; 

Op = Open [ i ]; 

Color = IIf( Cl > Op, colorGreen, colorRed ); 

GfxSelectPen ( Color ) ; 

GfxSelectSolidBrush ( Color ); 

bodyup = Max ( Op, Cl ); 
bodydn = Min ( Op, Cl ) ; 
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GfxEllipse ( i 


0.4, bodyup, i + 0.4, bodydn ); 


GfxMoveTo ( 
GfxLineTo ( 
GfxMoveTo ( 
GfxLineTo ( 


i, H [ i ] ) ; 

i, bodyup ); 
i, bodydn ); 

i, L [ i ] ) ; 


Z-ORDER SUPPORT 


Starting from version 5.80 AmiBroker supports piacing iow-ievei graphics in different Z-order iayers. A new 
GfxSetZOrder function is provided to aiiow this as shown in the exampie: 


Plot ( C, "Price", colorDefault ) ; 
GraphGridZOrder = 1 ; 

GfxSetZOrder ( 0 ) ; 

GfxSelectSolidBrush ( colorGreen ); 
GfxCircle ( 100, 100, 100 ) ; 


GfxSetZOrder (-1) ; 
GfxSelectSolidBrush ( colorRed ) ; 
GfxCircle ( 150, 150, 100 ) ; 


GfxSetZOrder (-2 ) ; 

GfxSelectSolidBrush ( colorBlue ) ; 
GfxCircle ( 180, 180, 100 ) ; 

Usage examples: 


Exampie 1. Pie-chart showing percentage hoiding of various kinds of sharehoiders 


Here is how it looks: 



Percent of shares held by: 

■ Insiders = 14% 

■ Institutions = 55.4% 

■ Others = 30.6% 


C-eatM wttn S-cxe' - adva'^i^d a'^a Z9 a'^ays s softAa'e. C'c<e'-30^ 


Here is the formula: 
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// OverlayMode = 2 means that nothing except 
// low-level gfx should be drawn 

// there will be no grid, no title line, no plots 
// and nothing except what we code using Gfx* calls 
GfxSetOverlayMode (2) ; 

HInsiders = GetFnData ( " InsiderHoldPercent " ); 

HInst = GetFnData (" InstitutionHoldPercent ") ; 

function DrawPiePercent( x, y, radius, startpct, endpct ) 

{ 

PI = 3.1415926; 
sa = 2 * PI * startpct / 100; 
ea = 2 * PI * endpct / 100; 
xsa = X + radius * sin ( sa ); 

ysa = y + radius * cos ( sa ); 

xea = X + radius * sin ( ea ); 

yea = y + radius * cos ( ea ) ; 

GfxPie ( X - radius, y - radius, x + radius, y + radius, xsa, ysa, xea, yea ); 

} 

radius = 0.45 * Status ( "pxheight ") ; // get pixel height of the chart and use 45% 
for pie chart radius 
textoffset =2.4 * radius; 

GfxSelectSolidBrush ( colorRed ); 

DrawPiePercent( l.l*radius, l.l*radius, radius, 0, HInsiders ); 

GfxRectangle ( textoffset , 42, textoffset +15, 57 ); 

GfxSelectSolidBrush ( colorBlue ); 

DrawPiePercent( l.l*radius, l.l*radius, radius, HInsiders, HInst + HInsiders ); 
GfxRectangle ( textoffset , 62, textoffset +15, 77 ); 

GfxSelectSolidBrush ( colorGreen ); 

DrawPiePercent( l.l*radius, l.l*radius, radius, HInst + HInsiders, 100 ); 
GfxRectangle ( textoffset , 82, textoffset +15, 97 ); 


GfxSelectFont ( "Times New Roman", 16, 700, True ) ; 

GfxTextOut ( "Percent of shares held by:", textoffset , 10 ); 

GfxSelectFont ( "Tahoma" , 12 ); 

GfxSetTextColor ( colorRed ) ; 

GfxTextOut ( "Insiders = " + HInsiders + "%", textoffset + 20, 40 ); 
GfxSetTextColor ( colorBlue ); 

GfxTextOut ( "Institutions = " + HInst + "%", textoffset + 20, 60 ); 

GfxSetTextColor ( colorGreen ); 

GfxTextOut ( "Others = " + ( 100 - (HInst+HInsiders) ) + "%", textoffset + 20, 80 

) ; 


GfxSelectFont ( "Tahoma" , 8 ); 
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Example 2. Formatted (table-like) output sample using low-level gfx functions 

// formatted text output sample via low-level gfx functions 


CellHeight = 20; 

CellWidth = 100; 

GfxSelectFont ( "Tahoma", CellHeight/2 ); 
function PrintInCell( string, row. Col ) 


GfxDrawText ( string. Col * CellWidth, row * CellHeight, (Col + 1 ) * CellWidth, 

(row + 1 ) * CellHeight, 0 ); 

} 


PrintInCell( 
PrintInCell( 
PrintInCell( 
PrintInCell( 
PrintInCell( 


"Open", 0, 0 ); 
"High", 0, 1 ); 
"Low", 0, 2 ); 
"Close", 0, 3 ); 
"Volume", 0, 4 ); 


GfxSelectPen ( colorBlue ); 
for ( i=l; i<10&&i< BarCount; i++ ) 


PrintInCell( 

StrFormat ( 

” e-rf ” 

-sg , 

Of 

i ] 

) , i. 

0 

) ; 

PrintInCell( 

StrFormat ( 

If 0,„lf 

-sg , 

H[ 

i ] 

) , i. 

1 

) ; 

PrintInCell( 

StrFormat ( 

If 0,„I! 

-sg , 

L[ 

i ] 

) , i. 

2 

) ; 

PrintInCell( 

StrFormat 

If 0, „ If 

-sg , 

C[ 

i ] 

) , i. 

3 

) ; 

PrintInCell( 

StrFormat ( 

If 0, ~ If 

-sg , 

V[ 

i ] 

) , i. 

4 

); 


GfxMoveTo ( 0, i * CellHeight ); 

GfxLineTo ( 5 * CellWidth, i * CellHeight ); 
} 


GfxMoveTo ( 0, i * CellHeight ); 

GfxLineTo ( 5 * CellWidth, i * CellHeight ); 


for ( Col = 1; Col < 6; Col++ ) 

{ 

GfxMoveTo ( Col * CellWidth, 0); 

GfxLineTo ( Col * CellWidth, 10 * CellHeight 

} 


Title=" "; 


Example 3. Low-level graphics demo featuring pie section, polygon, color-wheel, animated text and chart 
overlay 

// overlay mode = 1 means that 

// Low-level gfx stuff should come in background 
GfxSetOverlayMode (1) ; 
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Plot (C, "Close", colorBlack, styleCandle ) ; 

PI = 3.1415926; 

k = (GetPerf ormanceCounter ()/ 100 ) %2 56 ; 
for ( 1=0; i < 256; i++ ) 

{ 

x=2*PI*i/ 256; 

GfxMoveTo ( 100+k, 100 ); 

GfxSelectPen ( ColorHSB ( ( i + k ) % 256, 255, 255 ), 4 ); 

GfxLineTo ( 100 +k+ 100 * sin ( x ), 100 + 100 * cos ( x ) ); 

} 

GfxSelectFont ( "Tahoma" , 20, 700 ); 

GfxSetBkMode (1) ; 

GfxSetTextColor (colorBrown) ; 

GfxTextOut ( "Testing graphic capabilites" , 20, 128-k/2 ); 

GfxSelectPen ( colorRed ) ; 

GfxSelectSolidBrush ( colorBlue ); 

GfxChorddOO, 0,200,100,150,0,200,50); 

//GfxPie(100,0,200,100,150,0,200,50); 

GfxSelectPen ( colorGreen, 2 ) ; 

GfxSelectSolidBrush ( colorYellow ); 

GfxPolygon (250,200,200,200,250,0,200,50); 

RequestTimedRefresh ( 1 ) ; 

Example 4. Low-level graphic positioning - shows how to align bullt-ln plots() with the low-level graphics. Note 
that If scale changes (pxhelght changes) due to new data or different zoom level, It needs additional refresh to 
read new scale and adjust positions properly. 

Plot (C, "Price", colorBlack, styleLine ); 

GfxSetOverlayMode (0) ; 

Miny = Status ( "axisminy" ); 

Maxy = Status ( "axismaxy" ); 

Ivb = Status ( "lastvisiblebar" ); 
fvb = Status ( "firstvisiblebar" ); 

pxwidth = Status ( "pxwidth" ); 
pxhelght = Status ( "pxhelght ") ; 

TotalBars = Lvb - fvb; 

axisarea = 56; // may need adjustment if you are using non-default font for axis 
GfxSelectSolidBrush ( colorRed ) ; 
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GfxSelectPen ( colorRed ) ; 

for ( i = 0; i < TotalBars AND i < ( BarCount - fvb ); i++ ) 

{ 

X = 5 + i * (pxwidth - axisarea - 10) / ( TotalBars + 1 ); 
y = 5 + ( C[ i + fvb ] - Miny ) * ( pxheight - 10 )/ ( Maxy - Miny ); 
GfxRectangle ( x - 1, pxheight - y - 1, x + 2, pxheight - y + 2); 

} 
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Troubleshooting guide 

Quick jump: AmiQuote, data plugins (eSignal, myTrack, IQFeed, QuoteTracker, Quotes Plus, TC2000) 

CATEGORY: CRASH OR HANGUP 


Where, 

where 


Problem 


Reason 


Solution 


AmiBroker, 

Just after 
installation 


AmiBroker 
hangs at 
startup or 
frequent 
errors 
occur 


Download and install the latest FULL version of AmiBroker from 
http://www.amibroker.com/download.html 

Old/incompatible If you are running Windows 95, 98, NT 4: Install the latest 
system version of the Microsoft run-time files and operating system 

components components available here. 

If you are running Windows 95: Please check if you have 
Internet Explorer 4 or higher installed (6.0 recommended) 


Please try the following: 


AmiBroker, 


At startup 

(it was 
working 
fine before) 


AmiBroker 
crashes or 
hangs 


Corruption of 
some data file 


• rename default database directory and try to run 
AmiBroker, if it works it means that some files inside this 
database are corrupted. You may send us 
DEFAULT.AWL file from "Layouts" subfolder for 
checking 

• delete or rename all DEFAULT.AWL files that you can 
find on your disk and try to run AmiBroker. (.AWL files 
are created inside "Layouts" subfolder of main 
AmiBroker database and "Layout" subfolders of each 
database directory 

• rename broker.charts and broker.bcharts files (in 
AmiBroker directory) and try to run AmiBroker 

• rename default.layout file (in AmiBroker directory) and 
try to run AmiBroker 


AmiBroker, 




When 
running 
some AFL 

code 

AmiBroker 

crashes or 
hangs 

Bug in AFL 
formula or in 
AmiBroker 

Send offending code to AmiBroker support 
(bugs@amibroker.com) and delete / modify / comment-out it to 
continue to work until we find the reason of the problem and 
solution. 


CATEGORY: OTHER 


Where, when Problem 


Reason 


Solution 


AmiBroker, 


Help (User's HTMLHelp 

guide) is not system not 

accessible installed 


Install the update to the HTML Help system available 
from Microsoft here 


Troubleshooting guide 
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Just after 

Scripts do not 

Windows 

If you are running Windows 95, NT 4.0: Install Internet 

installation 

work 

Scripting Host 

Explorer 5 to activate Windows Scripting Host, or install 



not installed 

Microsoft Scripting engines available from 
http://msdn.microsoft.com/scripting/ 

AmiBroker, 

Some feature 

Missing 

Please check if you have not deleted any vital 


does not work 

component of 

AmiBroker files. 

At startup 


AmiBroker 

If you are unsure you may run the setup again over the 

(it was 



old installation (please do NQT uninstall if you want to 

working fine 
before) 



have your settings preserved) 

AmiQuote - 

Download from 

Livecharts 

Please go to the AmiQuote SETTINGS page, UNMARK 


Quote.com 

password 

"Use livecharts account" and select "SERVER #1" or 

Downloading 

fails 

incorrect or not 

follow exactly the instructions here 

quotes 

with 'the 

entered properly 



connection with 

as described 



the server is 

here 



reset' 

Yahoo is 



Download from 

blocking you. 



Yahoo starts 

After infamous 

If possible reconnect with diffferent IP (otherwise you 


fine but then 

Internet worm 

would need to wait half an hour or more until Yahoo 


stops 

attack, Yahoo 
considers quick. 

unblocks you) 


(especially on 

repeating 

go to the AmiQuote "Settings" and set "Initial delay 


DSL, ADSL, 

multiple 

between requests" to 1000 and "max number of 


cable modem 

downloads as a 

simultaneous downloads" to 1. 


connections) 

"denial of 

service" attack. 



Download from 

It may be too 

First check Yahoo historical page: 


Yahoo fails 

soon to get 
historical data 

http://table.finance.yahoo.com/k?s=utx&g=d 



from Yahoo or 

Yahoo 

temporary 

replace utx by the symbol in question. 



If the page shows old quotes - it is the problem with 

problem 


Yahoo not with AmiQuote. 


In fact AmiQuote uses 

" Downioad spreadsheet format" iink on previously 
mentioned page: 

http://table.finance.yahoo.com/k?s=utx&g=d 

If historical data are not available you can always use 
"Current" mode of AMIQuote to get the data of today 
(even during trading hours) 

If you do not know the ticker symbol for index or stock 
or mutual fund please 
use symbol lookup feature: 
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a) at Yahoo (for historical and current modes): 
http;//finance.yahoo.com/l 

b) at Lycos (for Intraday mode): 
http://finance.lycos.com/home/misc/symbol_search.asp 


Download Local 
works but there configuration 
are no quotes problem 
added 


Follow these steps to troubleshoot the problem 

• Go to C:\Program 

Files\AmiBroker\AmiQuote\Download and 
check if .AQH files are there. 

• Open them with Notepad and see if data are 
there 

• Check if you have aqh.format file in the Formats 
subdirectory of AMiBroker 

• Check its contents and eventually send me for 
checking 

• Try to import manually as per instructions given 
in the user's guide 

• If you ever restored data directory from CD 
ROM check the "read-only" flag of data files in 
AmiBroker database. They must not be 
read-only. If they are you have to mark all files 
in the data directory and all subfolders and 
UNMARK read only flag. 


AmiBroker 
/eSignal plugin 


AmiBroker 
/myT rack 
/IQFeed 
/QuoteTracker 
plugin 

AmiBroker 

/QuoteTracker 

plugin 

AmiBroker 
/any RT plugin 


AmiBroker 

/QuotesPlus 


Download from 
any source 
fails 

RT data 
spikes, bad 
ticks, other 
data problems. 

RT data 
spikes, bad 
ticks, other 
data problems. 

Data does not 
update 


Disconnection 


Error message 
"Can not 


Connection 

problem 

Connection 
problem or other 
reason 

Connection 
problem or other 
reason 


Not enough 
'ad-clicks' in 
QuoteTracker 

Connection 

problem 


Quotes Plus 
database 


Please check your internet connection. If you are using 
firewall make sure to allow AmiQuote (QUQTE.EXE) to 
access the internet on ports 80 and 443. 

Click with RIGHT mouse button over plug-in status area 
(green "QK" field) and choose "Fixup data for symbol" 
and wait a while. This will cause that entire intraday 
history for given symbol is re-downloaded. 

Click with RIGHT mouse button over green "QK" field 
and choose "Force backfill" and wait a while. This will 
cause that entire intraday history for given symbol is 
re-downloaded. 

You have to click on advertisements in QuoteTracker or 
register it. For more details see: 

http://www.amibroker.com/qthelp.html 

Click with RIGHT mouse button over plug-in status area 
(will show red "WAIT" or "SHUT") and choose 
"Disconnect" and then "Connect". If this does not help 
restart AmiBroker 

Check if Quotes Plus own chart program works - if not it 
means that this is a problem in QP2 database module 


Troubleshooting guide 


1315 


AmiBroker 6.00 User's Guide 


Technical information 


plugin 


initialize problem and you need to contact Quotes Plus technical support 

C-TREE" for help 


AmiBroker 
/TC2000 
/TCNet plugin, 
sometimes 


Error message 
"Variable or 
object not set" 


Timing problem 
inside TC2000 
own 

components. 


The only partial workaround to this problem is to move 
all data from TC2000 CDROM to your hard disk (by 
Hard disk lists). 


Miscellaneous questions 


Question 


Answer 


Must I use 
Internet Explorer? 
Can I use 
Netscape 
Navigator, Qpera, 
(other browser) 
instead? 


You can use any browser. In case of Windows 95 Internet Explorer 4 (or higher) 
installation is needed because it updates some of the Windows components (common 
controls library, HTML help, scripting) AmiBroker uses extensively. But after the 
installation you don't need to use Internet Explorer. 


Where is the help User's guide is available from Help->Help topics menu in AmiBroker (accessible also by 
file (manual)? F1 key) 
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Files and directories used by AmiBroker 

AmiBroker main directory - the directory where you installed AmiBroker. You can find main AmiBroker 

executable file (BROKER.EXE) there. 

PROGRAM FiLES 

• Broker.exe - main application file 

• CooiTooi.dii, MiscTooi.dii, Brokey.dii- additional application files required by broker.exe 

• HTMLView.exe - the report viewer, used to display backtest reports 

• emaiier.exe, emaiierssi.exe - a small add-on command line utilities that sends user-defined alerts 
via e-mail 

• DBCAPI.DLL - (present only if RT version is installed) - eSignal DBCAPI support library 

• Plugins - the subfolder that contains all plug-in DLLs. 

• unins000.exe and unins000.dat - uninstaller program. 

• Broker.chm - compiled HELP file 

DATA FILES 

• Data - default database folder, contains broker.master, broker.workspace, 0-9, A-Z, symbol 
data subfolders and Layouts subfolder. Read this to learn more about AmiBroker database 
concepts. 

• broker.master - binary data file containing the table of all symbols available in the database. Used for 
quick loading of symbols. The table of symbols includes information about assignments of symbols to 
categories (markets, groups, sectors, industries, watch lists, indices and favorites). If you delete this 
file AmiBroker will re-create it because this information is available also in the individual symbol data 
files. 

• broker.workspace - binary data file containing the information about the database settings (interval, 
data source used, etc), category names, global advance/decline data, etc. If you delete this file you 
will lost database settings and category names will be reset to defaults. 

• default.awl, *.awl - Amibroker Workspace layout files. Text files that contain the information about the 
layouts and chart sheets. The default.awl file stored in "Layouts" subfolder inside database folder 
contains default LOCAL layout for this database. The default.awl file stored in "Layouts" subfolder of 
AmiBroker main directory contains default GLOBAL layout (used when there is no local layout 
present). If you delete this file then default layout will be generated based on default.layout file that is 
supplied with AmiBroker. 

• broker.newcharts - binary file containing references between chart layouts and formula files used. If 
you delete it you will see "formula file empty or can not be found" in your charts because reference 
between chart ID and formula is lost. You will NOT however lose your formulas because formulas are 
separate. You will be able to reinsert them into your charts. 

• broker.layers - text file that contains information about chart layers. If you delete this file layers will 
be reset to factory defaults. 

• broker.groups, broker.markets, broker.sectors, broker.industries - text files that contain default 
names for groups, markets, sectors and industries. Used only at the database creation time. Later this 
information is stored per-database in broker.workspace file. If you delete them, AmiBroker will default 
to group n, market n, sector n, industry n names, where n is 1 ...256 

• broker.prefs - binary file that contains user preference settings (available from Tools->Preferences). 

If you delete this file AmiBroker will reset to factory default settings 

• broker.params - text file that contains persistent information about user-defined indicator parameters. 
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Crash recovery system and automatic bug reporting 

AmiBroker features a system of detecting and reporting bugs caiied "Crash recovery system". The name 
suggests that AmiBroker is now abie to recover from such unexpected situations and indeed it can!. 


How couid this be done? Weil... some tricks are needed to wrap the exception handling mechanism used by 
Windows :-) 

Normally when Windows application performs some illegal memory access, illegal operation (for example 
division by zero) or illegal instruction the system pops the dead-end message box saying "This program has 
performed an illegal operation and will be shut down". Now you have got no choice - the application is 
terminated when you click on OK button. 


AmiBroker's crash recovery system introduced in v3.47 beta intercepts the exception generated by Windows 
and instead of standard dead-end message box it displays the following dialog: 


AmiBroker crash recovery system 






An unhandled application error occurred. 

AmiBroker's built-in intelligent recovery system allows you to conbnue working 
with AmiBroker or exit the program immediatelly. 


If you choose Try to recover' the program may be unstable so it is advised to save your 
work and then exit the program. 

AmiBroker version 5.29.9.5099 

(cooltool.dll 5.29.9, mfc42.dll 6.6.8063, msvCTt.dll 7.0.7600 ) 


Try to Recover 


Microsoft Windows 7 version 6.1 (Build 7600) 
Service Pack 0.0 
Common Controls; 6.16 

Unhandled excepfion 
Type; CSysException 

Code; c0000005 

Desaiption; ACCESS VIOLATION 
Address; 77E7317F 


Exit program 


Copy to dip 


Troubleshoot 


You can send the above report now directly to AmiBroker.com for checking and possible 
resolution of the problem. No other information except shown above will be sent. 


Your e-mail (optional); 

Filling e-mail address wil allow us to respond to your report. 
To send anonymously leave it Wank. 


Send report 


As you can see there is a window that displays important system information and there are five buttons Try to 
recover, Exit program, Copy to clip, Troubleshoot, Send report. Clicking on the Exit program button 
works exactly the same as clicking on "OK" button in the standard Windows dead-end message box. But the 
first two buttons give you brand new possibilities. If you click on Try to recover button AmiBroker will try to 
recover from the error and continue running. In most cases you will be able to save your work and 
modifications you have made so you will not lose anything. In fact you will be able to work normally. There are 
however some cases when recovery will not succeed and AmiBroker may be unstable, so it is advised just to 
save your data and exit. It may also happen that this window will pop up for a couple of times - then you 
should just click on Try to recover several times. Copy to clip - copies bug report details with system 
information to clipboard so you can paste this information in e-mail program and send it to us. 

The recover function is quite nice but the main purpose of this system is to find and fix the problems in future 
version and this is why the most important function was provided - Send report. If you the crash recovery 
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window popped up on your screen please click on Send report button before attempting to continue work. 
This will automatically send the details shown in the crash recovery window to us. Please do add your e-mail 
(in Your e-mail field), so we can respond to your report. If you do not provide e-mail, the report will be sent 
anonymously, but we won't be able to respond to it and provide you any guidance. 

AmiBroker version 5.29,9.5099 

( cooltool.dll 5.29.9, mfc42.dll 6.6.8063, msvcrt.dll 7.0.7600 ) 

Microsoft Windows 7 version 6.1 (Build 7600) 

Service Pack 0.0 
Common Controls: 6.16 


Unhandled exception 
Type: CSysException 
Code: c0000005 

Description: ACCESS VIOLATION 
Address: 77E7317F 


Graph0=C; 
Sum{C,-C) 


Error 47. 

Exception occurred during AFL formula execution at address: 77E7317F, code: 
C0000005 

Detailed exception information: 

Broker,exe caused an EXCEPTION_ACCESS_VIOLATION in module ntdll.dll at 
0023:77E7317F, RtllmageNtHeader()+0411 byte(s) 

Call Stack: 

0023:77E7317F ntdll.dll, RtllmageNtHeader()+0411 byte(s) 

0023 : 77E73407 ntdll.dll, RtllmageNtHeader()+1059 byte(s) 

0023 : 77E732F2 ntdll.dll, RtllmageNtHeader()+0782 byte(s) 

CPU Registers: 

EAX=071BD978 EBX=071BCDA8 ECX=00000000 EDX=00000000 ESI=071BD970 
EDI=071B0000 EBP=00000000 ESP=0018F490 EIP=76D18FBA FLG=00010246 
CS=0023 DS=002B SS=002B ES=002B FS=0053 GS=002B 

AFL Parser status: 

Processing stage: EXCEPTION 
Formula ID: 1995 (Unnamed 190) 

Action 1 (INDICATOR) 

Additional information: 

Number of stock loaded: 35 
Currently selected stock: MCD 
Number of quotes (current stock): 751 

Workspace: 

Data source = (default). Data local mode = 1, NumBars = 250 

Preferences: 

Data source = (local). Data local mode = 1, NumBars = 1000 
Command history: 

2783 - Preferences settings—Preferences 

2824 - Shows AFL formula editor—Formula Editor 
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Cache manager stats: 

Number of list elements: 1 
Number of map elements: 1 
Hash table size: 5987 

Memory status: 

MemoryLoad: 25 % 

TotalPhys: 4194303K AvailPhys: 4194303K 
TotalPageFile: 4194303K AvailPageFile: 4194303K 
TotalVirtual: 4194176K AvailVirtual: 4029976K 

Last Windows message: 

HWnd: 0xl3075e 
Msg: 0x0110 
wParam: 0x0025092c 
IParam: 0x00000000 


As you can see AmiBroker generates itself most important details for the bug report including even some 
history of menu selections (Command history) but the most essential thing at this point is to provide the 
description of steps needed to reproduce the bug. It would be nice if you could send us also the e-mail with 
the description of steps required to reproduce the problem (what you have done before the bug occurred, 
what special conditions must be met to reproduce it, maybe an AFL formula that you have tried and anything 
that you suppose might be important (even though AmiBroker includes a few lines of offending formula 
automatically)). This is critical since automatically generated information is very nice but can not cover all the 
details. 

Clicking Troubleshoot brings up Troubleshooting page at http://www.amibroker.com/troubleshoot.html that 
contains descriptions of most common problems and how to solve them. 

Some final notes: I have put significant amount of work in making this system reliable, however you should be 
aware that not all exception and/or system errors could be handled by this system and it may happen that 
AmiBroker will not be able to recover from some fatal error. It is also possible that this system would not be 
able to intercept all low level exceptions. In that case just prepare the report by yourself giving me as much 
details as possible. 

Please remember that the final goal is making AmiBroker rock-solid and bug-free. This is what I am working 
on constantly. 


Crash recovery system and automatic bug reporting 


1320 


AmiBroker 6.00 User's Guide 


Technical information 


Performance tuning tips 

AmiBroker is one of the fastest (if not the fastest) technicai anaiysis program, stiii the user by appiying 
incorrect settings, poor formuia coding and other sub-optimum choices can significantiy siow it down. This 
short chapter we wiii give few hints on how to make program perform as it was originaiiy designed to. 

There are three areas of performance tuning: 

1. Operating system / machine ievei 

2. AmiBroker settings level 

3. Formula coding 

On operating system level you should do: 

• Avoid installing unnecessary 3rd party programs 

Specifically avoid all kinds of "memory turbo", "windows optimizers", "windows cleaners" and such 
tools as they bring just more load to the CPU and system resources and provide zero or virtually zero 
benefit. What is worse, they could affect normal operation of Windows and cause compatibility 
problems 

• Turn OFF virus checking for DATA files 

Many antiviruses turn on so called "live" protection on all files on all disks. This will bring system 
performance to its knees. Why? Simply because anti-virus will intercept each and every file access 
and run its extensive checking on each data access. This could result in drastic slow down of file 
accesses to the extent that Windows boots 3 times slower than normal. 

See the following article http://www.thepcspy.eom/read/what_really_slows_windows_down/5 that 
shows some real measurements on impact of anti-virus. 

While I am not saying to turn off antivirus completely, it is strongly recommended to turn OFF 
anti-virus checking on DATA FILES, specifically on all data files inside AmiBroker folder. 

Generally speaking there are two kind of files: executable (.exe, .dll, .ocx) and data files (.txt, .html, 
.wav, .jpg, .gif, .chm, etc...) . Checking data files for viruses makes actually very little or no sense at all 
because they don't contain any executable code therefore can not really be the source of infection. As 
long as file does not include any executable part - it is safe. Note however that some data files (such 
as Excel .xls, can contain macros and macros _are_ executable and can be infected). But as far as 
AmiBroker goes, anything inside AmiBroker directory that does not have .exe, .dll, or .js extension is 
non-executable and safe. 

• Choose anti-virus wisely 

As pointed out above, some anti-virus products can be really resource hogs and you should check the 
performance tests (see link above) before deciding on what antivirus to use. 

On AmiBroker settings level 

• Avoid unnecesarily large "Number of bars" in File->Database Settings 

This is the most often mistake people make. For example I have seen 50000 entered into "Number of 
bars" entered for end-of-day database. This does not make sense because 50000 daily bars is 192 
years!!! There is no data source that offers such history and entering that amount is waste of memory. 
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You need to keep in mind that what ever you enter here forces AmiBroker to actuaiiy aiiocate memory 
for that many bars. Each data bar is 40 bytes. So if you enter 100000 bars, you wiii force AmiBroker 
to actuaiiy aiiocate 4MB of memory *per symboi*. It may not sound too much but AmiBroker keeps a 
cache of recentiy used data and if you have defined the cache that is 500 symbois iarge you wiii be 
abie to hit 2GB of memory that way. So aiways look at what File->Database Settings dialog displays 
next to "Number of bars" field. It will display the number of days equivalent to entered number of bars 
and choosen base time interval. Make sure that you only enter resonable values and be aware that 
whatever you enter here has performance consequences. The consequences do not end with 
memory consumption alone, but also in speed. Processing more bars means more CPU time, 
especially considering the fact that while small amounts of data can be kept in on-chip CPU cache, 
large amounts can not. Now considering that on-chip cache is usually 10 (ten) times faster than 
regular memory you immediately realize that specifying too much bars here result in performance 
drop. Again: one bar is 40 bytes. For best performance, make sure that you don't exceed CPU 
on-chip cache size, so if your CPU has 4MB cache, for best performance it is strongly advised not to 
use more than 100000 bars in File->Database Settings. 

• Decrease the size of in-memory cache, if you are using very large databases (>2GB in disk size) 

The "in-memory cache" size defined in Tools->Preferences, "Data" tab controls the number of 
symbols in the cache and maximum amount of memory consumed by the cache. While larger cache 
generally speeds up processing because data do not need to be read from disk and written back all 
the time, you may run out of memory on certain situations when your cache is too large, especially on 
32-bit operating system that limits the available virtual memory per process to 2GB. To avoid running 
out of memory, go to Tools->Preferences, "Data" and decrease the size of in-memory cache. To set it 
to minimum, enter "11" (eleven) into "in-memory cache (max. symbols)". 

IMPORTANT: It is advised NOT to decrease the cache when your databases are relatively small (few 
hundred MB) as larger cache will speed up the access. Large cache is good thing as long as you do 
not run out of memory. 

On Formula coding level 

Poor formula coding is the foremost reason of slow down. People coming from "other" languages often do not 
realize the full potential of AFL array processing and code everything "old" style (i.e. with loops). Loops can be 
10..50 times slower than equivalent array-based code. So for best speed you should avoid loops at all 
replacing them with array processing, or at least make looping code as short as possible. 


Consider the following code: 

SetBarsRequired ( sbrAll ); 

GetPerformanceCounter ( 1 ) ; 

for ( i = 0; i<BarCount; i++) 

{ 

med[ i ] = (H[ i ] + L[ i ])/2; 

} 


"Loop time: "+GetPerformanceCounter ( 1 ); 
med = ( H + L ) /2 ; 

"Array time: "+GetPerformanceCounter (1) ; 


When running this code on 350000 bars the loop version it takes 100ms (0.1 s) to execute loop version and 

Performance tuning tips 1322 


AmiBroker 6.00 User's Guide 


Technical information 


only 2ms (0.002ms) to execute array version (so array code is 50 times faster than looping). The difference is 
not so significant with less bars, but still with even 300 bars, loop requires 0.1 ms and array needs 0.01 ms so it 
is 10 times faster. 

So there are few guidelines for AFL coding: 

• Use array processing instead of loops wherever possible. To learn more about array processing, 
please read the "Understanding the AFL" tutorial 

• Inside loops use scalars only or refer to individual array elements using [] subscript operator 

• Array operations and all loop invariant code should be moved outside of loops whenever possible to 
avoid repeated evaluation of the same function over and over 

Consider this code: 

f or ( i = 0; i < BarCount; i++ ) 

{ 

X = MA ( C, 10 ); // WRONG ! loop invariant code is called over and over 
! It should be OUTSIDE of loop 
Yf i ] = C[ i ]/x[ i ]; 

} 

The problem with the above code is that it repeats the same array-base moving average calculation 
with exactly same input over and over again (BarCount-times). The code like this is loop-invariant 
(does not depend on loop counter and does not have any input that is calculated depending on loop 
counter, so it can be calculated ONCE and as such should be moved outside (before) the loop, as 
shown below: 

X = MA ( C, 10 ); // CORRECT ! loop invariant code located OUTSIDE of loop 

f or ( i = 0; i < BarCount; i++ ) 

{ 

Yf i ] = C[ i ]/x[ i ]; 

} 

• Use the AFL Formula Editor, Tools->Code check & Profile to find out which functions are called how 
many times and which ones take the most time. Start your code tuning with functions that are called 
the most often. Check if they are loop invariants and if so, move them OUTSIDE the loop. 

• If you need to store array data in one formula and read it back in another, and were using 
AddToComposite/Foreign before, consider using array static variables (StaticVarGet/StaticVarSet) 
instead because static variables work faster. Note that static variable life is limited to program run 
lifetime (they are not persistent as AddToComposite tickers are). 

Performance monitoring 

In order to help you in real-time monitoring of program performance, AmiBroker provides two tools. First is 
Performance monitor window, second is Performance indicator that is located on the right most side of the 
AmiBroker status bar. 
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® Performance 
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The status bar performance indicator shows: 

• for reai time databases: percentage ioad factor indicator 

• for off-iine intraday and eod databases: free virtual memory 

Load Factor is a percentage value that shows relative 'snappiness' of the program. The load factor is 
calculated as (total chart refresh time in milliseconds)/2 + (total data access time in milliseconds)/2 + (free 
virtual memory below 20% of total memory available). So it will reach 100% if any of situations listed below 
happen: 

• total chart refresh time is higher than 200ms 

• total data access time is higher than 200ms 

• free virtual memory drops below 10% of total memory (or combination of above factors) 

Total chart refresh time is a sum of times needed to redraw completely all charts displayed on screen, it 
includes AFL execution time for each chart pane and GDI (graphics) output on screen. (It does not include 
data access) 

Total data access time is sum of times required to access fresh data via plugin for all displayed symbols plus 
time required to apply time filtering, and time compression from base interval to displayed interval. 

Plug-in time per symbol is time spent in plug-in GetQuotes call per ‘single* symbol. If you display 10 symbol 
charts at once AmiBroker will call GetQuotes 10 times so this time gets multiplied by number of symbols 
displayed (this total plugin time *is* included in total data access time figure - listed above) 

If Plug-in time per symbol exceeds 10ms it means that plugin is slow (or does not use new ADK 2.0), if this is 
the case you should contact plugin vendor to get updated plugin that uses ADK 2.0. 

Recommended is to keep this load factor below 100%. When load factor is 100% AmiBroker is able to keep 
updating all charts in real-time (more frequently than 5 times per second) and maintain responsive and 
smooth user-interface. With load factor of 200% AMiBroker is still able to keep updating all charts as frequenty 
as 2.5 times per second, but user interface reaction time may be impaired a bit. Keeping load at 100% or less 
is recommended. 

200% is maximum value that allows more or less "normal" operation. 

When load factor rises above 100% the warning tooltip will pop up once informing what is the reason of poor 
performance When load factor rises above 300% the above tooltip will reappear every minute. 

AmiBroker will continue working with loads even above 1000% however the performance will be bad (one 
update per 5 seconds or more). 
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Technical information 


Multithreading performance 

For more information about optimum use of muitithreading and other general remarks regarding performance 
see Efficient Use of Multithreading. 


Multithreading performance 
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How to purchase AmiBroker ? 


AmiBroker is a triaiware. This means that you SHOULD evaluate the trial version of the program for a 
period of 30 days before buying it. 

If you like the program and want to use it for more than 30 days evaluation period - you have to buy the 
license to use it. We assume that vou installed AmiBroker before ordering and checked if it fits vour needs. 

AmiBroker software is currentiy avaiiabie in 2 editions: Standard and Professionai (RT). To learn about 
the differences between these two versions click here. 

PRiCiNG 

One-time iicense fee is: 


New Singie-User Upgrade License 

Edition ,. 

License (only for registered users of previous versions) 

Standard 

$279 Buy Now! 

$139 

Professionai 

$339 BuyNow! 

$119 (from Standard Edition same 
version) 

$169 (from earlier versions) 


BENEFiTS: 


Here is what YOU gain purchasing AmiBroker: 

• the keyfiie enabling all features of the program (database saving, no more annoying requesters) 

• free upgrades for one year from the date of purchase (with minimum of two officiai major 
feature upgrades and 20 in-between beta versions) 

• access to members-oniy zone featuring 

♦ AmiBroker Deveioper Kit (for the developers of plugin DLLs) 

♦ newest issues AmiBroker Tips weekiy newsietter 

♦ monthly Stocks&Commodities® Traders' Tips for AmiBroker 

♦ newest, private versions of AmiBroker 

♦ extra AFL formulas for indicators, commentaries, trading systems 

• ability to influence the future of AmiBroker because your proposals of new features are much more 
likely to be implemented 

• 50% discount on next year of upgrade and maintenance pack 

• 12 month technicai support via e-mail 

• other bonuses 

DELiVERY 

After paying registration fee you will receive the personaiized keyfiie by e-maii. No other delivery methods 
are supported. When purchasing piease suppiy your e-maii address. 

HOW TO ORDER AMiBROKER? 

ORDERiNG ON-LiNE 

If you would like to buy AmiBroker, you can do the purchase online securely (128 bit SSL) using links below. 
Payment methods include all major credit cards as well as cheques and wire transfers. 
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How to purchase AmiBroker ? 


To place an order-on line, please visit: http://www.amibroker.com/order.html 

AmiBroker online ordering is provided by SWREG.ORG and Sharelt/element-5 AG a well established 
shareware registration and credit card processing agents. They handle registrations for over 7000 shareware 
programs. Their server uses your browser's powerful built in encryption and security, along with 
VeriSign/Thawte authentication, to encrypt your personal information and credit card details so that they 
cannot be intercepted by hackers or other third parties. 

All credit card data are transmitted using the secure (encrypted) HTTP protocol according to the current SSL 
(Secure Socket Layer) 128-bit strong cryptography standard. We have all heard a lot of talk about whether 
shopping on the internet is safe. The fact is that this year on-line shoppers will spend over $5.7 billion dollars 
according to International Data Corp. The main concern of on-line shoppers is that their credit card 
information will somehow end up in the wrong hands. SWREG.ORG and Sharelt/element-5 registration 
services use Secure Server technology, which encrypts your order information, keeping it private and 
protected. This technology is used by all the major commercial shopping sites. It is actually safer to transmit 
your credit card info over the Internet than it is to use your credit card around town. 

For more information on security matters, please consult your browser's documentation. Also please note that 
all information submitted in the online shop is 100% confidential - we won't sell or give away your email 
address or other details! 

ADDITIONAL INFORMATION 

On-line purchasing is the fastest way to obtain your personal registration code(s). Once you complete your 
registration, you will receive your personal data within 24 hours. 

It's of main importance that you give us a complete and correct Internet e-mail address. Entering an incorrect 
e-mail address (or an e-mail address that doesn't work correctly), you won't be able to register your software. 


E-mail us if you have any further questions regarding registration, future versions, and so on. 


BENEFITS: 
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Credits 


Thanks 

Many people make significant contributions to the development and testing of the AmiBroker. Thank you all. 
Thanks to Herman van den Bergen, Bill Barack, Bruce Robinson, Howard B. Bandy, Rick Perkins, Ken Close, 
Dimitris Tsokakis, Marek Ch^opek, Ed Winters, Patrick Hargus, Mark Leon, Dan Clark, Rick Parsons, Charlie 
Hooper, Steve Wiser, Jim Ellis, David Hoizgrefe, Carlton McEachern, Geoff Mulhall, Richard Cloonan, Peter 
Gialames, Stephane Carrasset, Dale Wingo, Fred Tonetti, Chuck Rademacher, Gary A. Serkhoshian, Rick 
Perkins, Tom Supera, Michael Robb, Mark Allen, Geo Singleman, Anthony Faragasso, Jayson Casavant, Al 
Hoizwarth, Sidney Kaiser, William Peters, Ara Kaloustian and all the other AmiBroker users for giving me 
valuable feedback, comments, ideas, suggestions, test results and all the support. Special thanks to eSignal, 
myTrack, IQFeed for their generous support and co-operation. Thanks to Jerry Medved (QuoteTracker) for 
co-operation. Thanks to Mark Jurik of Jurik Research for providing his tools. Special thanks to Gary Lyben of 
Quotes Plus for the help with interfacing to Quotes Plus database. Many thanks to all the contributors to the 
AFL formula library for sharing their work. Many thanks to Sharenet (Robin and Steve) and all South African 
users for their continuous support. Thanks to Jordan Russell and Martijn Laan for their InnoSetup/ISX. Thanks 
to Neil Hodgson for Scintilla control. Thanks to Donald Dailey for extensive support he provided for Amiga 
version of AmiBroker. The deepest thanks and love to my wife Elizabeth and kisses for our children Julia and 
Jacob and Nico for bringing so much joy to my life everyday. And thank You, Dear User, for purchasing 
AmiBroker! With your kind support we can make dreams come true. 

AmiBroker on the Web 

For latest news, patches and updates please check out AmiBroker/Win32 WWW site at: 
http://www.amibroker.com. (The backup site http://www.amibroker.net) 

Please check also AmiBroker Tips Newsletter available at: http://www.amibroker.com/newsletter 
Visit support section of AmiBroker web page at: http://www.amibroker.com/support.html 
Check AFL on-line library: 
http://www.amibroker.com/library/ 

DevLog: 

http://www.amibroker.com/devlog/ 

Knowledge Base: 
http://www.amibroker.com/kb/ 

AFL on-line reference: 
http://www.amibroker.com/guide/afl/ 

Third-part area (plugins, documentation): 
http://www.amibroker.net/3rdparty.php 
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Check AmiBroker message boards at: 
http://www.amibroker.net/boards/ 

Check AmiBroker maiiing lists at: 

http://www.egroups.com/messages/amibroker-news (announcements) 
http://www.egroups.com/messages/amibroker (general discussion) 
http://www.egroups.com/messages/amibroker-ts (trading systems) 
http://www.egroups.com/messages/amibroker-afl (AFL coding) 
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